查询源流或转码流实时质量数据

调用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. 查询的数据还未就绪

访问错误中心查看更多错误码。