直播推流信息接口(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
}
}
}
}