接口规范 查看在线用户

Posted 2020-10-21

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表示不支持或无法获取该参数。