接口规范 6. 查看在线用户
更新:HHH   时间:2023-1-7


6.查看在线用户

6.1.查询在线用户

  • 用途
    查询当前时间在线的用户数量,返回每个视频流观看用户的总数。
    请求
    statMgr/?request=connection_count

  • 响应
    {
    "code":0,
    "data":{
        "count":1,
        "items":[
            {
                "application":"live",
                "stream":"live2",
                "ver":"",
                "count":1
            }
        ]
    }
    }

    返回当前时间视频流的收看用户数。
    application 应用名
    stream 流名称
    ver 版本号,如果是收看的直播回看数据,会返回版本号
    count 用户数量

6.2.查询在线用户明细

  • 用途
    查询当前时间正在播放某个视频流的用户明细,包括用户的终端IP和使用的播放协议。
  • 请求
    statMgr/?request=connection_detail&application=live&stream=live2&version=
    application 应用名
    stream 流名称
    version 版本号,如果要查看收看某个直播回看流的用户数,需要提供版本号参数

  • 响应
    {
    "code":0,
    "data":{
        "count":1,
        "items":[
            {
                "cip":"192.168.1.88",
                "sip":"192.168.1.230:1935",
                "uid":"D48423AB19931A0A",
                "sid":"D48423AB19931A0A",
                "ver":"-1",
                "format":"rtmp",
                "type":"live",
                "reg_time":"1516261938",
                "start":"-1",
                "offset":"-1"
            }
        ]
    }
    }

    返回在线用户的明细数据。items元素下会包含0或多条记录。
    cip 客户端ip
    sip 服务器ip
    uid 用户唯一识别id,可以有应用系统带入
    sid 每次访问的唯一识别id
    ver 访问的哪个版本,对于视频点播流没有意义,对于回看流表示录制版本号
    reg_time 开始收看的时间,unix时间戳
    start 从视频的第几秒开始收看,-1表示从视频开头处收看。单位 秒
    offset 观看到了第几秒,该参数在用户收看hls和flv格式视频时有效。-1表示不支持或无法获取该参数。

返回开发技术教程...