文档中心

直播推流信息接口(stat)

描述

本接口采用标准的HyperText Transfer Protocol(HTTP)5/17/2016 12:57:53 PM **,接口的响应都包含在了HTTP的正文文本(Content text)。

金山云直播统计服务为客户提供实时的在线推流统计信息,包括RTMP推流的音视频编码详细信息,当前码率等。 金山云直播统计服务的请求中可选携带app和stream参数,可用于查询用户在某个app下的某个stream的实时统计信息。需要注意的是,当携带stream参数时,需要同时携带app参数,用于标示此stream属于某个特定的app。

请求参数

名称 类型 是否必须 描述
app String Y 频道
name String Y 流名

返回参数

名称 类型 描述
app array 频道
address 主播推流IP
bw_real 总实际码率,单位kb
flashver flash版本号
bw_in 总理论码率,单位kb

video

名称 类型 描述
width 视频宽度
frame_rate 视频帧率
codec 视频编码格式
profile 视频编码档次
bw_in_video 视频输入码率,单位kb
real_framerate 视频实时帧率
height 视频高度

audio

名称 类型 描述
profile 音频编码档次
codec 音频编码格式
channels 单/双通道
bw_in_audio 音频输入码率,单位kb
sample_rate 音频采样率,单位Hz

请求示例

http:// uniquename.dashboard.ks-cdn.com/v2/stat?app=live&name=stream_name

返回示例

响应的HTTP正文内容为json格式的字符串。

{
    "app": {                                           -- app包含一个频道集(array)
        "live": {                                      -- 频道名, 每个频道包含一个流集(array)
            "stream_name": {                           -- 流名
                "address": "111.1.59.51",              -- 主播推流IP
                "video": {                             -- 视频编码信息
                    "width": 360,                      -- 视频宽度        
                    "frame_rate": 25,                  -- 视频帧率
                    "codec": "H264",                   -- 视频编码格式
                    "profile": "High"                  -- 视频编码档次
                    "bw_in_video": "686.000000",       -- 视频输入码率,单位kb
                    "real_framerate":25,               -- 视频实时帧率
                    "height": 640,                     -- 视频高度               
                },
                "audio": {                             -- 音频编码信息
                    "profile": "LC",                   -- 音频编码档次
                    "codec": "AAC",                    -- 音频编码格式
                    "channels": 2,                     -- 单/双通道
                    "bw_in_audio": "75.609375",       -- 音频输入码率,单位kb
                    "sample_rate": 44100               -- 音频采样率,单位Hz
                },
                "bw_real": "664.843750",              -- 总实际码率,单位kb
                "flashver": "",
                "bw_in": "761.617188"                 -- 总理论码率,单位kb
                }
          }
     }
}