接口规范 6. 查看在线用户

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