全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频直播

查询在线人数

更新时间:2017-09-27 22:40:12

描述

获取在线直播流的实时在线人数。

实时查询在线人数的请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DescribeLiveStreamOnlineUserNum
DomainName String 您的加速域名
AppName String 直播流所属应用名称
StreamName String 直播流名称

返回参数

名称 类型 描述
TotalUserNumber Long 所有流的用户数总和
OnlineUserInfo LiveStreamOnlineUserNumInfo[] 每条直播流的用户数信息

数据类型

LiveStreamOnlineUserNumInfo

名称 类型 描述
StreamUrl String 直播流的 URL
UserNumber Long 直播流的在线人数
Time String 统计时刻 UTC 时间

特殊错误码

错误代码 描述 Http 状态码 语义
InternalError The request processing has failed due to some unknown error. 500 后台发生未知错误
InvalidDomain.NotFound The domain provided does not exist in our records. 404 当前账户下未查到域名
IllegalOperation Illegal domain operate is not permitted. 403 不支持当前操作,如:非直播类域名
InvalidStartTime.Malformed Specified parameter StartTime is not valid. 400 开始时间错误
InvalidEndTime.Malformed Specified parameter EndTime is not valid. 400 结束时间错误

示例

请求示例

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

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

返回示例

  • 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. }
  • XML格式

    1. <?xml version="1.0" encoding="UTF-8" ?>
    2. <DescribeLiveStreamOnlineUserNumResponse>
    3. <OnlineUserInfo>
    4. <LiveStreamOnlineUserNumInfo>
    5. <StreamUrl>rtmp://test101.cdnpe.com/live/test101</StreamUrl>
    6. <UserNumber>2</UserNumber>
    7. </LiveStreamOnlineUserNumInfo>
    8. <LiveStreamOnlineUserNumInfo>
    9. <StreamUrl>rtmp://test101.cdnpe.com/live/test102</StreamUrl>
    10. <UserNumber>5</UserNumber>
    11. </LiveStreamOnlineUserNumInfo>
    12. </OnlineUserInfo>
    13. <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
    14. <TotalUserNumber>7</TotalUserNumber>
    15. </DescribeLiveStreamOnlineUserNumResponse>
本文导读目录