实时查询直播推流质量数据_视频直播(LIVE)-阿里云帮助中心

使用说明

数据最大查询跨度为3小时。
数据最小查询跨度为5秒。
数据最大查询范围为30天。

QPS限制

本接口的单用户QPS限制为50次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveEdgeStreamRateData	系统规定参数。取值：DescribeLiveEdgeStreamRateData。
AppName	String	是	snapcall****	流所属应用名称。
DomainName	String	是	push-******-shanghai.ialicdn.com	推流域名。
StreamName	String	是	OssSnap****	流的名称。
StartTime	String	是	2024-06-23T12:30:00Z	所要查询时间段的起始时间。说明格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
EndTime	String	是	2024-06-23T14:30:00Z	所要查询时间段的结束时间。说明格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。注意结束时间大于开始时间。

返回数据

名称	类型	示例值	描述
RateDatas	Array of Data		帧率码率列表。
AudioFps	double	47	音频帧率。
AudioRate	double	160152	音频码率。
Time	String	2024-06-23T13:32:46Z	统计时间。说明格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
VideoFps	double	30	视频帧率。
VideoRate	double	1540040	视频码率。
DomainName	String	push-******-shanghai.ialicdn.com	推流域名。
StreamName	String	OssSnap****	流的名称。
IP	String	61...**	推流客户端IP。
AppName	String	snapcall****	应用名称。
VCodec	String	H264-High	视频编码。
ACodec	String	1456/AAC-LC	音频编码。
Resolution	String	1920x1080	分辨率。
RequestId	String	B6E125BE-E9B8-1103-8684-A3585CB6****	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveEdgeStreamRateData
&AppName=snapcall****
&DomainName=push-******-shanghai.ialicdn.com
&StreamName=OssSnap****
&StartTime=2024-06-23T12:30:00Z
&EndTime=2024-06-23T14:30:00Z
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveEdgeStreamRateDataResponse>
    <RateDatas>
        <AudioFps>47</AudioFps>
        <AudioRate>160152</AudioRate>
        <Time>2024-06-23T13:32:46Z</Time>
        <VideoFps>30</VideoFps>
        <VideoRate>1540040</VideoRate>
        <DomainName>push-******-shanghai.ialicdn.com</DomainName>
        <StreamName>OssSnap****</StreamName>
        <IP>61.**.**.**</IP>
        <AppName>snapcall****</AppName>
        <VCodec>H264-High</VCodec>
        <ACodec>1456/AAC-LC</ACodec>
        <Resolution>1920x1080</Resolution>
    </RateDatas>
    <RequestId>B6E125BE-E9B8-1103-8684-A3585CB6****</RequestId>
</DescribeLiveEdgeStreamRateDataResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RateDatas" : [ {
    "AudioFps" : 47,
    "AudioRate" : 160152,
    "Time" : "2024-06-23T13:32:46Z",
    "VideoFps" : 30,
    "VideoRate" : 1540040,
    "DomainName" : "push-******-shanghai.ialicdn.com",
    "StreamName" : "OssSnap****",
    "IP" : "61.**.**.**",
    "AppName" : "snapcall****",
    "VCodec" : "H264-High",
    "ACodec" : "1456/AAC-LC",
    "Resolution" : "1920x1080"
  } ],
  "RequestId" : "B6E125BE-E9B8-1103-8684-A3585CB6****"
}

错误码

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

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