查询实时音视频指标数据_视频直播(LIVE)-阿里云帮助中心

使用说明

可以查询最近30天内的数据，查询时间跨度不能超过24小时。
查询粒度：5分钟。

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveInteractionMetricData	系统规定参数。取值：DescribeLiveInteractionMetricData。
MetricType	String	是	FirstFrameCost	指标类型。取值： JoinChannelSucRate：5秒加入频道成功率。 VideoStuckRate：视频卡顿率。 AudioStuckRate：音频卡顿率。 FirstFrameCost：首帧耗时。
BeginTs	Long	是	1698195600000	开始时间，用UNIX时间戳表示，单位：毫秒。
EndTs	Long	是	1698201013000	结束时间，用UNIX时间戳表示，单位：毫秒。
Os	String	否	Android	操作系统。取值：iOS、Android。
TerminalType	String	否	mobile	终端类型。取值：web、mobile。
AppId	String	是	e4d7f08a-01fe-41b5-a091-fe41060a****	应用ID。

返回数据

名称	类型	示例值	描述
RequestId	String	A01C98C5-25AE-124A-83FE-514DF5C5BE36	请求ID。
SummaryData	String	2000	汇总数据。
Nodes	Array of Data		节点数据。
Timestamp	String	1548670257000	查询时间，用UNIX时间戳表示，单位：毫秒。
Value	String	66.670000	指标对应的值。

示例

请求示例

http(s)://live.aliyuncs.com?Action=DescribeLiveInteractionMetricData
&MetricType=FirstFrameCost
&BeginTs=1698195600000
&EndTs=1698201013000
&Os=Android
&TerminalType=mobile
&AppId=e4d7f08a-01fe-41b5-a091-fe41060a****
&公共请求参数

正常返回示例

XML格式

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

<DescribeLiveInteractionMetricDataResponse>
    <RequestId>A01C98C5-25AE-124A-83FE-514DF5C5BE36</RequestId>
    <SummaryData>2000</SummaryData>
    <Nodes>
        <Timestamp>1548670257000</Timestamp>
        <Value>66.670000</Value>
    </Nodes>
</DescribeLiveInteractionMetricDataResponse>

JSON格式

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

{
  "RequestId" : "A01C98C5-25AE-124A-83FE-514DF5C5BE36",
  "SummaryData" : "2000",
  "Nodes" : [ {
    "Timestamp" : "1548670257000",
    "Value" : "66.670000"
  } ]
}

错误码

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

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