指定された LiveChannel のストリームインジェストステータスを照会します。
リクエスト構文
GET /ChannelName?live&comp=stat HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValueリクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通のリクエストヘッダー」をご参照ください。
レスポンス要素
|
要素 |
タイプ |
説明 |
|
LiveChannelStat |
コンテナ |
GetLiveChannelStat リクエストのレスポンスを格納するコンテナです。 子ノード：Status、ConnectedTime、Video、Audio 親ノード：なし |
|
Status |
列挙文字列 |
LiveChannel の現在のストリームインジェストステータスです。 子ノード：なし 親ノード：LiveChannelStat 有効値：Disabled、Live、Idle |
|
ConnectedTime |
文字列 |
Status が Live の場合、この要素は現在のクライアントがストリームインジェストを開始した時刻を示します。 この要素の値は ISO 8601 形式です。 子ノード：なし 親ノード：LiveChannelStat |
|
RemoteAddr |
文字列 |
Status が Live の場合、この要素はストリームをインジェストしている現在のクライアントの IP アドレスを示します。 子ノード：なし 親ノード：LiveChannelStat |
|
Video |
コンテナ |
Status が Live の場合、ビデオストリーム情報を格納するコンテナです。 説明
Video コンテナと Audio コンテナは、Status が Live の場合にのみ返されます。 ただし、Status が Live の場合でも、これら 2 つのコンテナが必ず返されるとは限りません。 たとえば、クライアントが LiveChannel に接続しても、オーディオストリームまたはビデオストリームが送信されない場合、これら 2 つのコンテナは返されません。 子ノード：Width、Height、FrameRate、Bandwidth、Codec 親ノード：LiveChannelStat |
|
Width |
文字列 |
現在のビデオストリームの幅です。 単位：ピクセル。 子ノード：なし 親ノード：Video |
|
Height |
文字列 |
現在のビデオストリームの高さです。 単位：ピクセル。 子ノード：なし 親ノード：Video |
|
FrameRate |
文字列 |
現在のビデオストリームのフレームレートです。 子ノード：なし 親ノード：Video |
|
Bandwidth |
文字列 |
現在のビデオストリームのビットレートです。 単位：bit/s。 子ノード：なし 親ノード：Video |
|
Codec |
列挙文字列 |
現在のビデオストリームのエンコーディング形式です。 子ノード：なし 親ノード：Video |
|
Audio |
コンテナ |
Status が Live の場合、オーディオストリーム情報を格納するコンテナです。 説明
Video コンテナと Audio コンテナは、Status が Live の場合にのみ返されます。 ただし、Status が Live の場合でも、これら 2 つのコンテナが必ず返されるとは限りません。 たとえば、クライアントが LiveChannel に接続しても、オーディオストリームまたはビデオストリームが送信されない場合、これら 2 つのコンテナは返されません。 子ノード：SampleRate、Bandwidth、Codec 親ノード：LiveChannelStat |
|
SampleRate |
文字列 |
現在のオーディオストリームのサンプルレートです。 子ノード：なし 親ノード：Audio |
|
Bandwidth |
文字列 |
現在のオーディオストリームのビットレートです。 説明
Bandwidth は、直近期間のオーディオストリームまたはビデオストリームの平均ビットレートを示します。 LiveChannel が Live 状態に切り替わったとき、Bandwidth の戻り値は 0 になることがあります。 単位：bit/s。 子ノード：なし 親ノード：Audio |
|
Codec |
列挙文字列 |
現在のオーディオストリームのエンコーディング形式です。 子ノード：なし 親ノード：Audio |
例
-
リクエスト例 1
GET /test-channel?live&comp=stat HTTP/1.1 Date: Thu, 25 Aug 2016 06:22:01 GMT Host: test-bucket.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンス例 1
HTTP/1.1 200 content-length: 100 server: AliyunOSS connection: close x-oss-request-id: 57BE8E89B92475920B002164 date: Thu, 25 Aug 2016 06:22:01 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <LiveChannelStat> <Status>Idle</Status> </LiveChannelStat> -
リクエスト例 2
GET /test-channel?live&comp=stat HTTP/1.1 Date: Thu, 25 Aug 2016 06:25:26 GMT Host: test-bucket.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンス例 2
HTTP/1.1 200 content-length: 469 server: AliyunOSS connection: close x-oss-request-id: 57BE8F56B92475920B002187 date: Thu, 25 Aug 2016 06:25:26 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <LiveChannelStat> <Status>Live</Status> <ConnectedTime>2016-08-25T06:25:15.000Z</ConnectedTime> <RemoteAddr>10.1.2.3:47745</RemoteAddr> <Video> <Width>1280</Width> <Height>536</Height> <FrameRate>24</FrameRate> <Bandwidth>0</Bandwidth> <Codec>H264</Codec> </Video> <Audio> <Bandwidth>0</Bandwidth> <SampleRate>44100</SampleRate> <Codec>ADPCM</Codec> </Audio> </LiveChannelStat>