实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频服务端 API 参考实时数据监控获取实时分布质量数据 ListRealTimeQualityDistribution
复制全文
下载 pdf获取实时分布质量数据 ListRealTimeQualityDistribution
文档反馈
问问助手调用 ListRealTimeQualityDistribution 接口，查询应用在指定时间范围内的实时质量指标数据，并按地域、操作系统或网络类型等维度进行分布统计。
注意事项
- 最大请求次数：2 次/秒
- 可查询时间范围：最近 60 分钟
- 单次查询时间范围：60 分钟
- 数据延时：1 分钟
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=ListRealTimeQualityDistribution&Version=2023-11-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：ListRealTimeQualityDistribution
接口名称。当前 API 的名称为 ListRealTimeQualityDistribution。
Version String 必选 示例值：2023-11-01
接口版本。当前 API 的版本为 2023-11-01。
Body
AppId String 必选 示例值：66****3cf
StartTime String 必选 示例值：2022-12-12T14:00:00+08:00
查询起始时间戳，格式为 RFC3339。
EndTime String 必选 示例值：2022-12-12T14:10:00+08:00
查询结束时间戳，格式为 RFC3339。
Indicator String 必选 示例值：join_room_success_rate
Dimension String 必选 示例值：Province
查询的维度，一次仅支持查询一个维度。支持取值及含义如下：
- Province：一级行政区（包括港澳台地区）
- Country：国家
- OS：用户设备平台。支持取值：android、ios、linux、mac、windows
- Access：用户网络类型。支持取值：2g、3g、4g、5g、wifi
ProductType String 可选 示例值：native
要查询的产品类型，支持取值及含义如下：
- native（默认值）：Android、iOS、Linux、macOS或 Windows 系统。
- web：Web。
返回参数
Indicators Object[] 示例值：-
指标信息。
Data Object[] 示例值：-
指标数据。
Value Double 示例值：99.06
指标数值，保留两位小数。
Dimension String 示例值：windows
具体的维度信息。
TimeStamp String 示例值：2022-12-12T14:00:30+08:00
指标聚合时间，即指标值对应时间段的开始时刻（每 30s 一聚合）。格式为 RFC3339 规范。
Name String 示例值：5s_join_room_success_rate
指标名称。
请求示例
POST https://rtc.volcengineapi.com?Action=ListRealTimeQualityDistribution&Version=2023-11-01
{
"AppId": "661e7ae5543cf",
"StartTime": "2022-12-12T14:00:00+08:00",
"EndTime": "2022-12-12T14:01:00+08:00",
"Indicator": "join_room_success_rate",
"Dimension": "OS"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420",
"Action": "ListRealTimeQualityDistribution",
"Version": "2023-11-01",
"Service": "rtc",
"Region": "cn-north-1"
},
"Result": {
"Indicators": [
{
"Name": "join_room_success_rate",
"Data": [
{
"Timestamp": "2022-12-12T14:00:00+08:00",
"Value": 99.05,
"Dimension": "windows"
},
{
"Timestamp": "2022-12-12T14:00:00+08:00",
"Value": 99.24,
"Dimension": "ios"
},
{
"Timestamp": "2022-12-12T14:00:00+08:00",
"Value": 99.12,
"Dimension": "android"
},
{
"Timestamp": "2022-12-12T14:00:00+08:00",
"Value": 99.83,
"Dimension": "mac"
},
{
"Timestamp": "2022-12-12T14:00:00+08:00",
"Value": 100,
"Dimension": "linux"
},
{
"Timestamp": "2022-12-12T14:00:30+08:00",
"Value": 99.82,
"Dimension": "mac"
},
{
"Timestamp": "2022-12-12T14:00:30+08:00",
"Value": 99.49,
"Dimension": "linux"
},
{
"Timestamp": "2022-12-12T14:00:30+08:00",
"Value": 98.98,
"Dimension": "android"
},
{
"Timestamp": "2022-12-12T14:00:30+08:00",
"Value": 99.15,
"Dimension": "ios"
},
{
"Timestamp": "2022-12-12T14:00:30+08:00",
"Value": 99.06,
"Dimension": "windows"
}
]
}
]
}
}
错误码
最近更新时间：2026.08.19 18:24:15
这个页面对您有帮助吗？
有用
有用
无用
无用