指定されたLiveChannelのストリーム取り込みステータスを照会します。
リクエスト構文
GET /ChannelName?live&comp=stat HTTP/1.1
日付: GMT日付
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue
リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 説明 |
LiveChannelStat | Container | GetLiveChannelStatリクエストの返された結果を格納するコンテナー。 子ノード: ステータス、ConnectedTime、ビデオ、およびオーディオ 親ノード: なし |
ステータス | Enumerated string | LiveChannelの現在のストリーム取り込みステータス。 子ノード: なし 親ノード: LiveChannelStat 有効な値: [無効] 、[ライブ] 、および [アイドル] |
ConnnectedTime | String | StatusがLiveに設定されている場合、この要素は、現在のクライアントがストリームの取り込みを開始する時刻を示します。 要素の値はISO 8601形式です。 子ノード: なし 親ノード: LiveChannelStat |
RemoteAddr | String | StatusがLiveに設定されている場合、この要素はストリームを取り込む現在のクライアントのIPアドレスを示します。 子ノード: なし 親ノード: LiveChannelStat |
ビデオ | Container | StatusがLiveに設定されている場合、ビデオストリーム情報を格納するコンテナ。 説明 ビデオおよびオーディオコンテナは、StatusがLiveに設定されている場合にのみ返されます。 ただし、StatusがLiveに設定されている場合、これら2つのコンテナは必ずしも返されません。 たとえば、クライアントがLiveChannelに接続しているが、オーディオまたはビデオストリームが送信されていない場合、これらの2つのコンテナは返されません。 子ノード: 幅、高さ、フレームレート、帯域幅、およびコーデック 親ノード: LiveChannelStat |
幅 | String | 現在のビデオストリームの幅。 単位: ピクセル。 子ノード: なし 親ノード: ビデオ |
高さ | String | 現在のビデオストリームの高さ。 単位: ピクセル。 子ノード: なし 親ノード: ビデオ |
フレームレート | String | 現在のビデオストリームのフレームレート。 子ノード: なし 親ノード: ビデオ |
帯域幅 | String | 現在のビデオストリームのビットレート。 単位:bit/s。 子ノード: なし 親ノード: ビデオ |
コーデック | Enumerated string | 現在のビデオストリームのエンコード形式。 子ノード: なし 親ノード: ビデオ |
オーディオ | Container | StatusがLiveに設定されている場合にオーディオストリーム情報を格納するコンテナ。 説明 ビデオおよびオーディオコンテナは、StatusがLiveに設定されている場合にのみ返されます。 ただし、StatusがLiveに設定されている場合、これら2つのコンテナは必ずしも返されません。 たとえば、クライアントがLiveChannelに接続しているが、オーディオまたはビデオストリームが送信されていない場合、これらの2つのコンテナは返されません。 子ノード: SampleRate、帯域幅、およびコーデック 親ノード: LiveChannelStat |
SampleRate | String | 現在のオーディオストリームのサンプルレート。 子ノード: なし 親ノード: オーディオ |
帯域幅 | String | 現在のオーディオストリームのビットレート。 説明 帯域幅は、最近の期間のオーディオストリームまたはビデオストリームの平均ビットレートを示します。 LiveChannelがLive状態に切り替えられると、Bandwidthの戻り値は0になり得る。 単位:bit/s。 子ノード: なし 親ノード: オーディオ |
コーデック | Enumerated string | 現在のオーディオストリームのエンコード形式。 子ノード: なし 親ノード: オーディオ |
例
- サンプルリクエスト1
GET /test-channel?live&comp=stat HTTP/1.1 日付: 8月25日2016日木曜日06:22:01 GMT ホスト: test-bucket.oss-cn-hangzhou.aliyuncs.com 承認: OSS YJjHKOKWDWINLKXv:fOzwkAgVTVSO1VKLPIInQ0JY ****
HTTP/1.1 200のサンプルレスポンス1content-length: 100 server: AliyunOSS 接続: 閉じる x-oss-request-id: 57BE8E89B92475920B002164 日付: 8月2016日木曜日06:22:01 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <LiveChannelStat> <ステータス> アイドル </ステータス> </LiveChannelStat>
- サンプルリクエスト2
GET /test-channel?live&comp=stat HTTP/1.1 日付: 8月25日2016日木曜日06:25:26 GMT ホスト: test-bucket.oss-cn-hangzhou.aliyuncs.com 承認: OSS YJjHKOKWDWINLKXv:WeC5joEaRzfSSS8xK0tlo7WT ****
HTTP/1.1 200レスポンス2のサンプル content-length: 469 server: AliyunOSS 接続: 閉じる x-oss-request-id: 57BE8F56B92475920B002187 日付: 8月2016日木曜日06:25:26 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <LiveChannelStat> <ステータス> ライブ </ステータス> <ConnectedTime>2016-08-25T06:25:15.000Z</ConnectedTime> <RemoteAddr>10.1.2.3:47745</RemoteAddr> <ビデオ> <Width>1280</Width> <高さ> 536</高さ> <FrameRate>24</FrameRate> <Bandwidth>0</Bandwidth> <コーデック> H264</コーデック> </ビデオ> <オーディオ> <Bandwidth>0</Bandwidth> <SampleRate>44100</SampleRate> <Codec>ADPCM</Codec> </オーディオ> </LiveChannelStat>