全部产品
对象存储 OSS

GetLiveChannelStat

更新时间:2017-06-07 13:26:11   分享:   

本接口用来获取指定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>
本文导读目录
本文导读目录
以上内容是否对您有帮助?