Classic/VPC環境で利用できます。
ライブチャンネルに配信中ストリームのメタデータを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /api/v2/channels/{channelId}/streamMetadata |
リクエストヘッダ
Live Station APIで共通して使用されるヘッダの詳細は、Live Stationのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
channelId |
String | Required | チャンネル ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/streamMetadata' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content |
Object | - | ストリームのメタデータ情報 |
content.video |
Object | - | ビデオトラック情報 |
content.video.width |
Integer | - | 出力ビデオの幅(ピクセル) |
content.video.height |
Integer | - | 出力ビデオの高さ(ピクセル) |
content.video.fps |
Float | - | 1秒当たりのフレーム数(fps) |
content.video.bitrate |
Integer | - | ビデオストリームのビットレート(bps) |
content.audio |
Object | - | オーディオトラック情報 |
content.audio.bitrate |
Integer | - | オーディオストリームのビットレート(bps) |
レスポンスステータスコード
Live Station APIで共通して使用されるレスポンスステータスコードの詳細は、Live Stationのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"content": {
"video": {
"width": 1920,
"height": 1080,
"fps": 30.0,
"bitrate": 4026912
},
"audio": {
"bitrate": 192320
}
}
}