直播在线人数 直播带宽 API

最近更新时间:2017-08-16 00:01:45

关于鉴权

  • 鉴权使用的签名算法是 HMAC-SHA1,密钥对是 Qiniu 账号的 AccessKey/SecretKey

播放信息

实时播放人数带宽

  • 查询实时的播放人数以及播放带宽

规格

请求包:

GET /v2/hubs/<Hub>/stat/play
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
  • <Hub>: 直播空间名

返回包:

200   {
         "total" : {
            "bandwidth" : <Bandwidth>,
            "count" : <Count>
         },
         "streams" : {
            "<Key>" : {
               "count" : <StreamCount>,
               "bandwidth" : <StreamBandwidth>
            },
            ...
         }
      }
  • total.bandwidth: 总的播放带宽,单位bps
  • total.count: 总的播放人数
  • Key: 流名,形如 rtmp://xxxx/dctest/test中的test
  • Key.bandwidth: 这个流的播放带宽,单位bps
  • Key.count: 这个流的播放人数

返回示例

{
   "total" : {
      "count" : 3,
      "bandwidth" : 2858352
   },
   "streams" : {
      "4233c75485d12b" : {
         "bandwidth" : 979176,
         "count" : 1
      },
      "234c123413b" : {
         "count" : 2,
         "bandwidth" : 1879176
      },
   }
}

历史时间段内的播放人数带宽

  • 查询过去一段时间内的播放人数带宽
  • 返回的列表以5分钟为间隔

规格

请求包:

GET /v2/hubs/<Hub>/stat/play/history?start=<Start>&end=<End>&limit=<Limit>&marker=<Marker>
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
  • <Hub>: 直播空间名
  • <Start>: 开始时间戳。不填,默认一小时前的时间戳
  • <End>: 结束时间戳。不填,默认当前时间戳
  • <Limit>: 返回的列表个数限制。不填,默认1000
  • <Marker>: 如果上一次返回的结果超过了limit,则会返回marker表示上一次读取到哪条记录。这一次请求带上marker后,继续从该marker后开始读取

返回包:

200   {
         "marker" : "<Marker>",
         "items" : [
            {
               "time" : <Time>,
               "stats" : {
                  "count" : <Count>,
                  "bandwidth" : <Bandwidth>
               }
            },
            ...
         ]
      }
  • marker: 若这次请求items个数超过了limit,读取到哪条记录记为marker
  • items.time: 这条记录的的时间戳,对齐到5分钟
  • items.stats: 这个5分钟内的平均播放人数以及播放带宽,带宽单位bps

返回示例

{
   "items" : [
      {
         "time" : 1480919100,
         "stats" : {
            "bandwidth" : 12718720,
            "count" : 40
         }
      },
      {
         "time" : 1480919400,
         "stats" : {
            "bandwidth" : 13451332,
            "count" : 41
         }
      }
   ],
   "marker" : ""
}

某个时间点内各个流的播放人数带宽

  • 查询过去某个时间点内各个流的播放人数带宽
  • 时间点会对齐到5分钟,所以结果是5分钟内的平均结果

规格

请求包:

GET /v2/hubs/<Hub>/stat/play/history/detail?time=<Time>
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
  • <Hub>: 直播空间名
  • <Time>: 时间戳,必填。服务端会把该时间对齐到最近的5分钟

返回包:

200   {
         "items" : [
            {
               "time" : <Time>,
               "key" : "<Key>",
               "stats" : {
                  "bandwidth" : <Bandwidth>,
                  "count" : <Count>
               }
            },    
            ...
         ]
      }
  • key: 流名,形如 rtmp://xxxx/dctest/test中的test
  • stats.bandwidth: 播放带宽,单位bps
  • stats.count: 播放人数
  • time: 时间戳,对齐到5分钟。

返回示例

{
   "items" : [
      {
         "time" : 1480868400,
         "key" : "fe352d8a5",
         "stats" : {
            "bandwidth" : 2139564,
            "count" : 1
         }
      },
      {
         "time" : 1480868400,
         "key" : "fa12341a3",
         "stats" : {
            "bandwidth" : 0,
            "count" : 0
         }
      }
   ]
}
以上内容是否对您有帮助?
  • Close