GetLiveChannelStat -

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>