获取通话质量指标
更新时间不可用
获取指定通话的质量指标数据。
GET
https://api.sd-rtn.com/beta/analytics/call/metrics鉴权
start_tsnumber必填
查询的时间范围起点。Unix 时间戳(秒)。
end_tsnumber必填
查询的时间范围终点。Unix 时间戳(秒)。
appidstring必填
你的项目使用的 App ID。
call_idstring必填
通话 ID,即通话的唯一标识。
sidsstring必填
请求的用户通话 sid 列表。最多可以指定 20 个 sid,多个 sid 用逗号隔开。
响应
OK
响应 Body
codenumber响应状态码。200 表示请求成功,详见响应状态码。
messagestring错误消息。
requestIdstring对应请求的 ID。
各个用户通话(sid)的具体指标数据。
sidstring用户在该通话中的唯一标识。
用户通话的质量指标数据。
midnumber指标 ID。详见下表:
mid | 描述 | 单位 | 举例 |
|---|---|---|---|
| 20001 | App 的 CPU 使用率 | % | 27% |
| 20002 | 系统 CPU 使用率 | % | 15% |
| 20003 | 音频发送码率 | Kbps | 126 Kbps |
| 20004 | 音频接收码率 | Kbps | 108 Kbps |
| 20005 | 音频渲染卡顿时间 | ms | 106.67 ms |
| 20006 | 视频小流发送码率 | Kbps | 472 Kbps |
| 20007 | 视频采集帧率 | fps | 16 fps |
| 20008 | 视频大流发送帧率 | fps | 12 fps |
| 20009 | 视频大流接收码率 | Kbps | 309 Kbps |
| 20030 | 视频小流接收码率 | Kbps | 100 Kbps |
| 20010 | 视频大流接收帧率 | fps | 6 fps |
| 20031 | 视频小流接收帧率 | fps | 6 fps |
| 20011 | 视频渲染卡顿时间 | ms | 2000.50 ms |
| 20015 | 音频上行丢包率 | % | 1% |
| 20016 | 音频端到端丢包率 | % | 3% |
| 20017 | 视频上行丢包率 | % | 5% |
| 20018 | 视频端到端丢包率 | % | 7% |
| 20019 | 视频大流接收分辨率的宽 | px | 360 |
| 20020 | 视频大流接收分辨率的高 | px | 640 |
| 20032 | 视频小流接收分辨率的宽 | px | 360 |
| 20033 | 视频小流接收分辨率的高 | px | 640 |
| 20021 | SDK 任务调度延迟 | ms | 2 ms |
| 20022 | 客户端到本地路由器的往返时延(表征 Wi-Fi 信号质量) | ms | 3 ms |
| 20023 | 视频小流发送帧率 | fps | 108 fps |
| 20024 | 视频大流发送码率 | Kbps | 126 Kbps |
| 20025 | 采集音量 | dB | 105 dB |
| 20026 | 播放音量 | dB | 98 dB |
| 20027 | 视频大流发送分辨率的宽 | px | 360 |
| 20028 | 视频大流发送分辨率的高 | px | 640 |
| 20034 | 视频小流发送分辨率的宽 | px | 360 |
| 20035 | 视频小流发送分辨率的高 | px | 640 |
| 20036 | WebRTC 下行视频丢包率 | / | / |
| 20037 | WebRTC 上行音频丢包率 | / | / |
| 20038 | WebRTC 上行视频丢包率 | / | / |
| 20039 | APP 内存占用 | % | 50% |
| 20040 | 系统内存占用 | % | 70% |
kvsarray<unknown>时间戳及相应时间的指标数值。
peer_uidnumber远端用户的 ID。如果为 0,表示收到的是本地用户的指标数据。
请求示例
curl --request GET \
--url "https://api.sd-rtn.com/beta/analytics/call/metrics?start_ts=1550024508&end_ts=1550025508&appid=string&call_id=15c995xxxxxxxxxxxd39be9b&sids=sids%3DSXXXXXXXXXXXXXXXX1%2CSXXXXXXXXXXXXXXXX2" \
--header 'Authorization: Basic <credentials>'响应示例
{
"code": 0,
"message": "错误消息。",
"requestId": "对应请求的 ID。",
"metrics": [
{
"sid": "用户在该通话中的唯一标识。",
"data": [
{
"mid": 0,
"kvs": null,
"peer_uid": 0
}
]
}
]
}