1. 程式人生 > >接口規範 查看在線用戶

接口規範 查看在線用戶

cati sid 使用 如果 atm ems 1.2 for 包含

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

接口規範 查看在線用戶