通话中质量监测
功能介绍
在音视频通话或会议过程中,可通过 SDK 提供的接口监测网络质量与各媒体流的质量信息,用于在界面上展示网络状态,以及视频/屏幕共享的实时分辨率、帧率、码率等,便于排查卡顿、模糊等问题。
注意:
需成功进入房间后,网络状态与流信息才有实际意义;流信息仅在对应流已存在时才能获取成功。
1. 网络质量监测
1.1 监听网络状态变化
网络状态变化时 SDK 会主动回调,无需轮询。
@Override
void netStateChanged(int level) {
// level:网络评分 0~10(10 为最佳网络)
// 可在此更新 UI 上的网络状态展示
}
相关 API 请参考:
2. 媒体流质量信息
可获取视频流的实时参数(宽高、帧率、码率、编码类型),用于展示当前流质量或做自适应策略。
流信息结构 VideoStreamInfo 字段说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| w | short | 图像宽 |
| h | short | 图像高 |
| fps | float | 帧率 |
| bps | int | 码率,单位:bit/秒 |
| codecID | CODEC_ID | 编码类型 |
2.1 视频流信息
获取指定用户、指定设备的视频流信息。
UsrVideoId cam = new UsrVideoId("12345678", (short) -1); // -1 代表默认视频设备
VideoStreamInfo streamInfo = RTCMeeting.getInstance().getVideoStreamInfo(cam);
if (streamInfo != null) {
// streamInfo.w, h, fps, bps, codecID 有效
}
// 流不存在时返回 null
相关 API 请参考:
3. 使用说明
| 能力 | 接口 / 回调 | 典型用途 |
|---|---|---|
| 网络评分 | netStateChanged | 界面显示「网络良好/一般/差」、信号图标 |
| 视频流 | getVideoStreamInfo | 展示某路视频的分辨率、帧率、码率 |
建议在进入房间后,结合 netStateChanged 做网络状态展示;需要诊断或展示某路流质量时,再按需调用 getVideoStreamInfo(流未建立时会返回 null,需做好判断)。