GetLiveChannelStat介面用於擷取指定LiveChannel的推流狀態資訊。
請求文法
GET /ChannelName?live&comp=stat HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
要求標頭
此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)。
響應元素
名稱 | 類型 | 描述 |
LiveChannelStat | 容器 | 儲存GetLiveChannelStat返回結果的容器。 子節點:Status、ConnectedTime、Video、Audio 父節點:無 |
Status | 枚舉字串 | LiveChannel當前的推流狀態原因。 子節點:無 父節點:LiveChannelStat 有效值:Disabled、Live、Idle |
ConnnectedTime | 字串 | 當Status為Live時,表示當前用戶端開始推流的時間。此元素使用ISO8601格式表示。 子節點:無 父節點:LiveChannelStat |
RemoteAddr | 字串 | 當Status為Live時,表示當前推流用戶端的IP地址。 子節點:無 父節點:LiveChannelStat |
Video | 容器 | 當Status為Live時,儲存視頻流資訊的容器。 說明 Video、Audio容器只有在Status為Live時才會返回,但Status為Live時不一定返回這兩個容器。例如,用戶端已經串連到LiveChannel,但尚未發送音視頻資料,這種情況不會返回這兩個容器。 子節點:Width、Height、FrameRate、Bandwidth、Codec 父節點:LiveChannelStat |
Width | 字串 | 當前視頻流的畫面寬度。 單位:像素 子節點:無 父節點:Video |
Height | 字串 | 當前視頻流的畫面高度。 單位:像素 子節點:無 父節點:Video |
FrameRate | 字串 | 當前視頻流的幀率。 子節點:無 父節點:Video |
Bandwidth | 字串 | 當前視頻流的碼率。 單位:B/s 子節點:無 父節點:Video |
Codec | 枚舉字串 | 當前視頻流的編碼格式。 子節點:無 父節點:Video |
Audio | 容器 | 當Status為Live時,儲存音頻流資訊的容器。 說明 Video、Audio容器只有在Status為Live時才會返回,但Status為Live時不一定返回這兩個容器。例如,用戶端已經串連到LiveChannel,但尚未發送音視頻資料,這種情況不會返回這兩個容器。 子節點:SampleRate、Bandwidth、Codec 父節點:LiveChannelStat |
SampleRate | 字串 | 當前音頻流的採樣率。 子節點:無 父節點:Audio |
Bandwidth | 字串 | 當前音頻流的碼率。 說明 Bandwidth為音頻流/視頻流最近一段時間內的平均碼率。LiveChannel剛切換到Live狀態時,返回的Bandwidth值可能為0。 單位:B/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: OSS qn6q**************:77Dv****************
返回樣本 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: OSS qn6q**************:77Dv****************
返回樣本 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>