查询源流或转码流实时质量数据
调用DescribeLiveCenterStreamRateData查询直播中心收录的流音视频帧率和码率。
使用说明
返回时间粒度为5秒一个点位，单次查询不能超过3个小时的范围，可以查询30天内的数据。
QPS限制
本接口的单用户QPS限制为50次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | DescribeLiveCenterStreamRateData | 系统规定参数。取值：DescribeLiveCenterStreamRateData。 |
| AppName | String | 是 | liveApp**** | 流所属应用名称。 |
| DomainName | String | 是 | demo.aliyundoc.com | 推流域名。 |
| StreamName | String | 是 | liveStream**** | 流的名称。 |
| StartTime | String | 是 | 2024-03-05T18:00:53Z | 起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 |
| EndTime | String | 是 | 2024-03-05T18:01:03Z | 结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RateDatas | Array of Data | 帧率码率列表。 |
|
| AudioFps | String | 47 | 音频帧率。 |
| AudioRate | String | 600 | 音频码率。 |
| Time | String | 2024-03-05T18:00:53Z | 统计时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 |
| VideoFps | String | 30 | 视频帧率。 |
| VideoRate | String | 1953584 | 视频码率。 |
| RequestId | String | B6E125BE-E9B8-1103-8684-A3585CB632F1 | 请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveCenterStreamRateData
&AppName=liveApp****
&DomainName=demo.aliyundoc.com
&StreamName=liveStream****
&StartTime=2024-03-05T18:00:53Z
&EndTime=2024-03-05T18:01:03Z
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveCenterStreamRateDataResponse>
<RequestId>B6E125BE-E9B8-1103-8684-A3585CB632F1</RequestId>
<RateDatas>
<VideoFps>30</VideoFps>
<VideoRate>1953584</VideoRate>
<AudioFps>47</AudioFps>
<AudioRate>600</AudioRate>
<Time>2024-03-05T18:00:53Z</Time>
</RateDatas>
</DescribeLiveCenterStreamRateDataResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B6E125BE-E9B8-1103-8684-A3585CB632F1",
"RateDatas" : [ {
"VideoFps" : "30",
"VideoRate" : "1953584",
"AudioFps" : "47",
"AudioRate" : "600",
"Time" : "2024-03-05T18:00:53Z"
} ]
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | Meter.ParamError | Param Error:%s,Please Check Again. | 报错信息 |
| 403 | Meter.AuthError | Authentication Failed,Please Try Again. | 鉴权失败 |
| 500 | Meter.ServerInternalError | The Request Processing Has Failed Due To Some Unknown Error. | 服务内部异常 |
| 500 | Meter.DataSourceQueryError | Data Source Error:%s,Please Try Again. | 数据查询错误 |
| 502 | Meter.ReadyTsError | Get ReadyTs Failed,Please Try Again. | 查询的数据还未就绪 |
访问错误中心查看更多错误码。