音视频通话

通话中质量监测

功能介绍

在音视频通话或会议过程中,可通过 SDK 提供的接口监测网络质量,用于在界面上展示网络状态,以及影音共享的实时分辨率、帧率、码率等,便于排查卡顿、模糊等问题。

注意:

需成功进入房间后,网络状态与流信息才有实际意义;流信息仅在对应流已存在时才能获取成功。

1. 网络质量监测

可主动查询或通过回调获知本端与房间服务器之间的网络状态,用于展示"网络良好/一般/较差"或详细丢包、延时数据。

1.1 获取网络状态评价

获取 0~10 的网络评分,10 代表网络最好,便于做简单 UI 展示。

// 得到网络状态评价,0~10,10 代表网络很好
const level = sdk_engine.getNetState();

相关 API 请参考:

1.2 获取网络状态详情

获取包含延时、音视频收发丢包率等详细信息的结构体,便于做质量统计或诊断。

const info = sdk_engine.getNetState2();
// info 包含网络评价、延时等详细信息

结构体说明请参考:CRNetStateInfo

相关 API 请参考:

1.3 监听网络状态变化

网络状态变化时 SDK 会主动回调,无需轮询。

sdk_engine.on("notifyNetStateChanged", (level) => {
  // level:网络评分 0~10(10 分为最佳网络)
  // 可在此更新 UI 上的网络状态展示
})

相关 API 请参考:

2. 影音共享流信息

获取当前影音共享流的实时参数(存在影音共享时有效)。

const streamInfo = sdk_engine.getMediaStreamInfo();
if (streamInfo) {
  // streamInfo 包含流的质量参数
}

结构体说明请参考:CRVStreamInfo

相关 API 请参考:

3. 使用说明

能力 接口 / 回调 典型用途
网络评分 getNetState、notifyNetStateChanged 界面显示"网络良好/一般/差"、信号图标
网络详情 getNetState2 展示延时、音视频丢包率,或上报质量数据
影音流 getMediaStreamInfo 展示影音共享的分辨率、帧率、码率

建议在进入房间后,结合 notifyNetStateChanged 做网络状态展示;需要诊断或展示影音流质量时,按需调用 getMediaStreamInfo(流未建立时会返回空,需做好判断)。