音视频通话

通话中质量监测

功能介绍

在音视频通话或会议过程中,可通过 SDK 回调监测本端与房间服务器之间的网络质量,用于在界面上展示网络状态。

注意:需成功进入房间后,网络状态才有实际意义。

Unity SDK 目前仅提供被动监听方式,暂不提供主动查询网络状态的接口(如 getNetState)。

1. 网络状态变化通知

SDK 会在网络状态变化时主动回调 notifyNetStateChanged,参数 level 为 0~10 的网络评分,10 代表网络最好。

private void notifyNetStateChanged(int level)
{
    // 根据 level 更新 UI,如:优(8~10)、良(5~7)、差(0~4)
    if (level >= 8)
    {
        // 网络良好
    }
    else if (level >= 5)
    {
        // 网络一般
    }
    else
    {
        // 网络较差,可提示用户
    }
}

在初始化阶段将 notifyNetStateChanged 注册为会议回调,写法参考 实现音视频通话。

相关 API 请参考:

2. 使用建议

  • 可在 UI 上展示网络信号图标,网络较差时提示用户检查网络环境
  • 断线处理参见 连接状态管理