通话中质量监测
功能介绍
在音视频通话或会议过程中,可通过 SDK 提供的接口监测网络质量与各媒体流的质量信息,用于在界面上展示网络状态、丢包率、延时,以及视频/影音/屏幕共享的实时分辨率、帧率、码率等,便于排查卡顿、模糊等问题。
注意:
需成功进入房间后,网络状态与流信息才有实际意义;流信息仅在对应流已存在时才能获取成功。
1. 网络质量监测
可主动查询或通过回调获知本端与房间服务器之间的网络状态,用于展示“网络良好/一般/较差”或详细丢包、延时数据。
1.1 获取网络状态评价
获取 0~10 的网络评分,10 代表网络最好,便于做简单 UI 展示。
// 得到网络状态评价,0~10,10 代表网络很好
int level = g_sdkMain->getSDKMeeting().getNetState();
相关 API 请参考:
1.2 获取网络状态详情
获取包含延时、音视频收发丢包率等详细信息的结构体,便于做质量统计或诊断。
CRNetStateInfo info = g_sdkMain->getSDKMeeting().getNetState2();
// info._lv - 网络评价 0~10(10 为最佳)
// info._delay - 网络延时,单位 ms
// info._aSndLost - 语音发送丢包率
// info._aRcvLost - 语音接收丢包率
// info._vSndLost - 视频发送丢包率
// info._vRcvLost - 视频接收丢包率
结构体说明请参考:CRNetStateInfo
相关 API 请参考:
1.3 监听网络状态变化
网络状态变化时 SDK 会主动回调,无需轮询。
void YourCallBack::notifyNetStateChanged(int level)
{
// level:网络评分 0~10(10 分为最佳网络)
// 可在此更新 UI 上的网络状态展示
}
相关 API 请参考:
2. 媒体流质量信息
可获取视频、影音共享、屏幕共享等媒体流的实时参数(宽高、帧率、码率、编码类型),用于展示当前流质量或做自适应策略。
流信息结构 CRVStreamInfo 字段说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| _w | short | 图像宽 |
| _h | short | 图像高 |
| _fps | float | 帧率 |
| _bps | int | 码率,单位:bit/秒 |
| _codecID | CRVSDK_CODEC_ID | 编码类型 |
2.1 视频流信息
获取指定用户、指定设备的视频流信息(支持标准流与第二档流)。
CRUserVideoID vID;
vID._userID = "12345678"; // 用户 ID,可为本地或远端
vID._videoID = -1; // 默认视频设备
CRVStreamInfo streamInfo;
bool ok = g_sdkMain->getSDKMeeting().getVideoStreamInfo(
streamInfo,
vID,
CRVSDK_VSTP_LV0 // 标准流;第二档流使用 CRVSDK_VSTP_LV1
);
if (ok) {
// streamInfo._w, _h, _fps, _bps, _codecID 有效
}
// 流不存在时返回 false
相关 API 请参考:
结构体请参考:CRUserVideoID、CRVSDK_VSTEAMLV_TYPE
2.2 影音共享流信息
获取当前影音共享流的实时参数(存在影音共享时有效)。
CRVStreamInfo streamInfo;
bool ok = g_sdkMain->getSDKMeeting().getMediaStreamInfo(streamInfo);
if (ok) {
// streamInfo._w, _h, _fps, _bps, _codecID 有效
}
相关 API 请参考:
2.3 屏幕共享流信息
获取当前屏幕共享流的实时参数(存在屏幕共享时有效)。
CRVStreamInfo streamInfo;
bool ok = g_sdkMain->getSDKMeeting().getScreenShareStreamInfo(streamInfo);
if (ok) {
// streamInfo._w, _h, _fps, _bps, _codecID 有效
}
相关 API 请参考:
3. 使用说明
| 能力 | 接口 / 回调 | 典型用途 |
|---|---|---|
| 网络评分 | getNetState、notifyNetStateChanged | 界面显示“网络良好/一般/差”、信号图标 |
| 网络详情 | getNetState2 | 展示延时、音视频丢包率,或上报质量数据 |
| 视频流 | getVideoStreamInfo | 展示某路视频的分辨率、帧率、码率 |
| 影音流 | getMediaStreamInfo | 展示影音共享的分辨率、帧率、码率 |
| 屏幕共享流 | getScreenShareStreamInfo | 展示屏幕共享的分辨率、帧率、码率 |
建议在进入房间后,结合 notifyNetStateChanged 做网络状态展示;需要诊断或展示某路流质量时,再按需调用对应的 getXxxStreamInfo(流未建立时会返回 false,需做好判断)。