开发者社区> 问答> 正文

关于LiveChannel的操作之如何实现GetLiveChannelStat?

本接口用来获取指定LiveChannel的推流状态信息。

请求语法GET /ChannelName?live&comp=stat HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue





响应元素

名称描述
LiveChannelStat保存GetLiveChannelStat返回结果的容器。类型:容器子节点:Status,ConnectedTime,Video,Audio父节点:无
StatusLiveChannel当前的推流状态描述。类型:枚举字符串子节点:无父节点: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。


示例



请求示例IGET /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 YJjHKOKWDWINLKXv:fOzwkAgVTVSO1VKLPIInQ0JYyOA=





返回示例IHTTP/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>





请求示例IIGET /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 YJjHKOKWDWINLKXv:WeC5joEaRzfSSS8xK0tlo7WTK1I=





返回示例IIHTTP/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>



展开
收起
青衫无名 2017-10-23 10:13:03 1657 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
低代码开发师(初级)实战教程 立即下载
冬季实战营第三期:MySQL数据库进阶实战 立即下载
阿里巴巴DevOps 最佳实践手册 立即下载