Pili 直播 > API 文档 > 直播流管理API >查询流统计数据

查询流统计数据

最近更新时间: 2023-02-13 14:24:54

接口描述

查询直播流历史码率、历史帧率、播放人数、播放带宽、域名级别人数带宽等信息。

请求参数

GET /v2/hubs/<Hub>/streams/<EncodedStreamKey>/stats?start=<Start>&end=<End>
Host: pili.qiniuapi.com
Authorization: <QiniuToken>

<QiniuToken>: 管理凭证，用于鉴权。其值为符合管理凭证的字符串

参数	类型	必填	描述
hub	string	是	直播空间名
encodedStreamTitle	string	是	经过base64编码的直播流名
start	int64	否	查询的起始时间 (该接口只能获取一天的统计数据， end-start不能超过24小时)，Unix时间戳，默认当前时间前1小时
end	int64	否	查询的结束时间 (该接口只能获取一天的统计数据， end-start不能超过24小时)，Unix时间戳，默认为当前时间

返回数据

参数	类型	描述
items	object []	流统计信息列表
├─ hub	string	流所属的直播空间名
├─ time	integer	统计时间，时间戳，单位秒
├─ stream	string	流名
├─ stats	object	流具体的统计信息
├─ bps	integer	推流码率
├─ videoFps	integer	推流视频帧率
├─ audioFps	integer	推流音频帧率
├─ width	integer	SPS 宽度
├─ height	integer	SPS 高度
├─ videoCodec	string	metadata视频编码规格
├─ videoProfile	string	metadata视频编码配置
├─ videoFrameRate	integer	SPS视频帧率
├─ audioCodec	string	metadata音频编码规格
├─ audioChannel	integer	metadata音频频道数
├─ audioSampleRate	integer	metadata音频采样率
├─ playCount	integer	播放人数
├─ bandwidth	integer	播放带宽
├─ detailStats	object []	域名详细统计列表
├─ domain	string	域名
├─ type	string	域名类型
├─ playCount	integer	播放人数
├─ bandwidth	integer	播放带宽

示例

请求体:

GET /v2/hubs/xrtest/streams/MTEy/stats?start=1676268540&end=1676268570 HTTP/1.1
Host: pili.qiniuapi.com 
Authorization: <QiniuToken> 
Content-Type: application/x-www-form-urlencoded

返回体:

200 {
	"items": [
		{
			"hub": "Hub",
			"time": <Time>,
			"stream": "Stream",
			"stats": {
				"bps": <Bps>, // 推流码率
				"videoFps": <VideoFps>, // 推流视频帧率
				"audioFps": <AudioFps>, // 推流音频帧率
				"width": <Width> , // SPS宽度
				"height": <Height> , // SPS高度
				"videoCodec": <VideoCodec>, // metadata视频编码规格
				"videoProfile": <VideoProfile>, // metadata视频编码配置
				"videoFrameRate": <VideoFrameRate>, // SPS视频帧率
				"videoBitRate": <VideoBitRate> , // 视频码率, 单位bps
				"audioCodec": <AudioCodec> , // metadata音频编码规格
				"audioChannel": <AudioChannel>, // metadata音频频道数
				"audioSampleRate": <AudioSampleRate>, // metadata音频采样率
				"audioBitRate": <audioBitRate> , // 音频码率, 单位bps
				"playCount": <PlayCount> , // 播放人数
				"bandwidth": <Bandwidth> , // 播放带宽
				"detailStats": [
					{
						"domain": "Domain",
						"type": "Type",
						"playCount": "PlayCount", // 域名播放人数
						"bandwidth": "Bandwidth" // 域名播放带宽
					},
				...	
				]
			}

		},
	...
	]
}

// 未找到流信息返回
200 {
	"items": []
}

以上内容是否对您有帮助？