接口規范 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表示不支持或無法獲取該參數。