全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
视频直播

查询直播流实时在线人数

更新时间:2018-04-26 17:22:33

描述

查询实时直播流的当前在线人数,即实时拉流数

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeLiveStreamOnlineUserNum

系统规定参数,取值:DescribeLiveStreamOnlineUserNum

DomainName String www.yourdomain.com

您的加速域名

AppName String testApp

直播流所属应用名称

StreamName String testStream

直播流名称

返回参数

参数 类型 示例值 描述
TotalUserNumber Long 2

所有流的用户数总和

OnlineUserInfo

每条直播流的用户数信息

  └StreamUrl String rtmp://play.aliyunlive.com/AppName/StreamName

直播流的 URL

  └UserNumber Long 2

直播流的在线人数

  └Time String 2015-12-01T17:37:00Z

统计时刻 UTC 时间 格式:2015-12-01T17:37:00Z

示例

请求示例

  1. https://live.aliyuncs.com/?Action=DescribeLiveStreamOnlineUserNum&DomainName=test101.cdnpe.com&<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

正常返回示例

XML 格式

  1. <DescribeLiveStreamOnlineUserNumResponse>
  2. <OnlineUserInfo>
  3. <LiveStreamOnlineUserNumInfo>
  4. <StreamUrl>rtmp://test101.cdnpe.com/live/test101</StreamUrl>
  5. <UserNumber>2</UserNumber>
  6. </LiveStreamOnlineUserNumInfo>
  7. <LiveStreamOnlineUserNumInfo>
  8. <StreamUrl>rtmp://test101.cdnpe.com/live/test102</StreamUrl>
  9. <UserNumber>5</UserNumber>
  10. </LiveStreamOnlineUserNumInfo>
  11. </OnlineUserInfo>
  12. <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  13. <TotalUserNumber>7</TotalUserNumber>
  14. </DescribeLiveStreamOnlineUserNumResponse>

JSON 格式

  1. {
  2. "OnlineUserInfo":{
  3. "LiveStreamOnlineUserNumInfo":[
  4. {
  5. "StreamUrl":"rtmp://test101.cdnpe.com/live/test101",
  6. "UserNumber":2
  7. },
  8. {
  9. "StreamUrl":"rtmp://test101.cdnpe.com/live/test102",
  10. "UserNumber":5
  11. }
  12. ]
  13. },
  14. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  15. "TotalUserNumber":7
  16. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录