閱讀489 返回首頁    go 英雄聯盟


GetLiveChannelStat__關於LiveChannel的操作_API 參考_對象存儲 OSS-阿裏雲

本接口用來獲取指定LiveChannel的推流狀態信息。

請求語法

  1. GET /ChannelName?live&comp=stat HTTP/1.1
  2. Date: GMT date
  3. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  4. Authorization: SignatureValue

響應元素

名稱 描述
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時,保存視頻流信息的容器。
類型:容器
子節點:Width,Heigth,FrameRate,Bandwidth,Codec
父節點:LiveChannelStat
Width 表示當前視頻流的畫麵寬度(單位:像素)。
類型:字符串
子節點:無
父節點:Video
Heigth 表示當前視頻流的畫麵高度(單位:像素)。
類型:字符串
子節點:無
父節點:Video
FrameRate 表示當前視頻流的幀率。
類型:字符串
子節點:無
父節點:Video
Bandwidth 表示當前視頻流的碼率(單位:B/s)。
類型:字符串
子節點:無
父節點:Video
Codec 表示當前視頻流的編碼格式。
類型:枚舉字符串
子節點:無
父節點:Video
Audio 當Status為Live時,保存音頻流信息的容器。
類型:容器
子節點:SampleRate,Bandwidth,Codec
父節點:LiveChannelStat
SampleRate 表示當前音頻流的采樣率。
類型:字符串
子節點:無
父節點:Audio
Bandwidth 表示當前音頻流的碼率(單位:B/s)。
類型:字符串
子節點:無
父節點:Audio
Codec 表示當前音頻流的編碼格式。
類型:枚舉字符串
子節點:無
父節點:Audio

細節分析

  1. Video,Audio容器隻有在Status為Live時才會返回,但Status為Live時不一定會返回Video,Audio容器,例如,客戶端已經連接到LiveChannel,但尚未發送音視頻數據時不會返回。
  2. Bandwidth為音頻流/視頻流最近一段時間內的平均碼率,LiveChannel剛切換到Live狀態時,返回的Bandwidth值可能為0。

示例

請求示例I

  1. GET /test-channel?live&comp=stat HTTP/1.1
  2. Date: Thu, 25 Aug 2016 06:22:01 GMT
  3. Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
  4. Authorization: OSS YJjHKOKWDWINLKXv:fOzwkAgVTVSO1VKLPIInQ0JYyOA=

返回示例I

  1. HTTP/1.1 200
  2. content-length: 100
  3. server: AliyunOSS
  4. connection: close
  5. x-oss-request-id: 57BE8E89B92475920B002164
  6. date: Thu, 25 Aug 2016 06:22:01 GMT
  7. content-type: application/xml
  8. <?xml version="1.0" encoding="UTF-8"?>
  9. <LiveChannelStat>
  10. <Status>Idle</Status>
  11. </LiveChannelStat>

請求示例II

  1. GET /test-channel?live&comp=stat HTTP/1.1
  2. Date: Thu, 25 Aug 2016 06:25:26 GMT
  3. Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
  4. Authorization: OSS YJjHKOKWDWINLKXv:WeC5joEaRzfSSS8xK0tlo7WTK1I=

返回示例II

  1. HTTP/1.1 200
  2. content-length: 469
  3. server: AliyunOSS
  4. connection: close
  5. x-oss-request-id: 57BE8F56B92475920B002187
  6. date: Thu, 25 Aug 2016 06:25:26 GMT
  7. content-type: application/xml
  8. <?xml version="1.0" encoding="UTF-8"?>
  9. <LiveChannelStat>
  10. <Status>Live</Status>
  11. <ConnectedTime>2016-08-25T06:25:15.000Z</ConnectedTime>
  12. <RemoteAddr>10.1.2.3:47745</RemoteAddr>
  13. <Video>
  14. <Width>1280</Width>
  15. <Height>536</Height>
  16. <FrameRate>24</FrameRate>
  17. <Bandwidth>0</Bandwidth>
  18. <Codec>H264</Codec>
  19. </Video>
  20. <Audio>
  21. <Bandwidth>0</Bandwidth>
  22. <SampleRate>44100</SampleRate>
  23. <Codec>ADPCM</Codec>
  24. </Audio>
  25. </LiveChannelStat>

最後更新:2016-11-23 16:04:18

  上一篇:go PostVodPlaylist__關於LiveChannel的操作_API 參考_對象存儲 OSS-阿裏雲
  下一篇:go GetLiveChannelInfo__關於LiveChannel的操作_API 參考_對象存儲 OSS-阿裏雲