通话前网络质量探测

更新时间: 2024/03/15 17:26:13

在网络会议、重要直播等对音视频通话质量等要求较高的场景下,需要在通话前进行调试,例如检测上下行网络质量,以提前识别网络问题或判断当前网络环境下适合的音视频流码率。NERTC SDK 支持网络测速功能,帮助您保证高质量的音视频通话体验。

功能介绍

自 V4.5.0 起,NERTC SDK 提供通话前网络探测相关接口与回调方法,用户在加入房间前可以探测当前设备到网易云信边缘服务器的网络状态,即上下行 last mile 的网络质量,包括带宽、丢包率、网络抖动和往返时延等数据,以判断或预测本端当前的网络状况。

网络质量探测的基本原理是 NERTC SDK 向网易云信边缘服务器节点发送一批网络探测数据包,然后分析返回数据包的质量,通过回调以数据报告的形式返回给客户端。

基本原理图如下:

网络质量探测.png

  • 当上行测速结果显示丢包率较高时,推荐使用降低分辨率或降低帧率等方法降低推流码率,以保证正常推流。
  • 当下行测速结果显示丢包率较高时,推荐使用视频流回退功能指定远端拉取低码率的流,以保证正常拉流。

注意事项

  • 请在加入房间前使用网络质量探测功能,即 startLastmileProbeTest 需要在 joinChannelWithToken 之前调用。
  • 调用 startLastmileProbeTest 进行通话前网络质量探测时,会消耗一定的网络流量。因此调用方法后,建议在收到 onNERtcEngineLastmileProbeTestResult 回调之前不要调用其他方法,避免因 API 操作过于频繁导致其他方法无法执行。
  • 开启网络测试后,NERTC SDK 会根据当前设置的视频分辨率自动调整探测码率。
  • 视频通话期间请勿测试,以免影响通话质量。

示例项目源码

网易云信提供 通话前网络质量检测的示例项目源码 SpeedTest,您可以参考该源码实现通话前网络质量检测。

API 调用时序

sequenceDiagram
    participant 应用层
    participant NERtcSDK
    应用层 ->> NERtcSDK: init 初始化 NERtcEngine
    Note over 应用层, 云信服务器: 通话前网络质量探测
    应用层 ->> NERtcSDK: startLastmileProbeTest
    NERtcSDK-->>应用层: onNERtcEngineLastmileQuality
    Note right of NERtcSDK: 通知网络质量状态,约 5 秒内返回。
    NERtcSDK-->>应用层: onNERtcEngineLastmileProbeTestResult
    Note right of NERtcSDK: 报告网络质量详细数据,约 30 秒内返回。
    应用层 ->> NERtcSDK: stopLastmileProbeTest
    Note over 应用层, 云信服务器: 加入房间、离开房间
    应用层 ->> NERtcSDK: joinChannelWithToken
    NERtcSDK ->> 云信服务器: 请求加入房间
    NERtcSDK-->>应用层: onNERtcEngineUserDidJoinWithUserID:userName
    应用层 ->> NERtcSDK: leaveChannel
    NERtcSDK-->>应用层: onNERtcEngineDidLeaveChannelWithResult
    应用层 ->> NERtcSDK: release 销毁 NERtcEngine

实现方法

  1. 注册探测回调监听。

    • onNERtcEngineLastmileQuality:描述本端用户在加入频道前的 last mile 网络探测的结果,以打分形式描述上下行网络质量的主观体验,您可以通过该回调预估本地用户在音视频通话中的网络体验。该回调视网络情况在约 5 秒内返回。
    • onNERtcEngineLastmileProbeTestResult:描述本地用户在加入频道前的 last mile 网络探测详细报告,报告中通过客观数据反馈上下行网络质量,包括网络抖动、丢包率等数据。您可以通过该回调客观预测本地用户在音视频通话中的网络状态。该回调视网络情况在约 30 秒内返回。

    示例代码如下:

    //在遵循 NERtcEngineDelegateEx 协议的对象中实现如下回调,监听通话前网络上下行 last mile 质量状态回调
    - (void)onNERtcEngineLastmileQuality:(NERtcNetworkQuality)quality {
    //根据实际的业务场景向用户展示以打分的主观形式评估的网络上下行质量
    }
    
    - (void)onNERtcEngineLastmileProbeTestResult:(NERtcLastmileProbeResult *)result {
    //根据实际的业务场景向用户展示上下行网络质量的实际探测数据
    }
    
  2. 在加入房间前,调用 startLastmileProbeTest 方法进行网络质量探测,并通过 NERtcLastmileProbeConfig 结构体设置是否探测上行或下行网络以及对应的期望码率,相关参数的说明如下表所示。

    参数 参数说明
    expectedUplinkBitrate 本端期望的最高发送码率。单位为 bps,取值范围为 100000 ~ 5000000。推荐参考 setLocalVideoConfig 中的视频编码码率设置该参数的值。
    expectedDownlinkBitrate 本端期望的最高接收码率。单位为 bps,取值范围为 100000 ~ 5000000。
    probeUplink 是否探测上行网络。
    • YES:探测上行网络。
    • NO:不探测上行网络。不发流的用户,例如直播房间中的普通观众,无需进行上行网络探测。
    probeDownlink 是否探测下行网络。
    • YES:探测下行网络。
    • NO:不探测下行网络。

    示例代码如下:

    NERtcLastmileProbeConfig *probeConfig = [[NERtcLastmileProbeConfig alloc] init];
    probeConfig.probeUplink = //是否开启上行探测;
    probeConfig.probeDownlink = //是否开启下行探测;
    probeConfig.expectedUplinkBitrate = //预期最高发送探测码率;
    probeConfig.expectedDownlinkBitrate = //预期最高接收码率;
    [[NERtcEngine sharedEngine] startLastmileProbeTest:probeConfig];
    
  3. 成功调用探测方法后,测速结果将在 onNERtcEngineLastmileQualityonNERtcEngineLastmileProbeTestResult 回调中返回。

    • onNERtcEngineLastmileQualityquality 参数以打分的主观形式评估网络上下行质量,具体枚举值说明如下表所示。
    枚举值 说明
    kNERtcNetworkQualityUnknown 质量未知
    kNERtcNetworkQualityExcellent 质量极好
    kNERtcNetworkQualityGood 用户主观体验相当于极好,但码率可能略低。
    kNERtcNetworkQualityPoor 用户主观体验有瑕疵,但不影响沟通。
    kNERtcNetworkQualityBad 勉强能沟通,但不顺畅。
    kNERtcNetworkQualityVeryBad 网络质量非常差,基本不能沟通。
    kNERtcNetworkQualityDown 完全无法沟通。
    • onNERtcEngineLastmileProbeTestResult 通过 NERtcLastmileProbeResult 提供客观数据反馈上下行网络质量,具体参数说明如下表所示。
    参数 参数说明
    state 反映本次网络质量探测结果的状态:
    • kNERtcLastmileProbeResultComplete:本次进行了完整的网络质量探测。
    • kNERtcLastmileProbeResultIncompleteNoBwe:本次未进行完整的网络质量探测,缺少带宽预测,通常因为测试资源暂时受限。
    • kNERtcLastmileProbeResultUnavailable:本次未进行网络质量探测,通常因为网络连接中断。
    rtt 网络延时,单位为毫秒(ms)。
    uplinkReport 上行网络质量探测结果报告。
    downlinkReport 下行网络质量探测结果报告。

    其中网络质量探测结果报告中包括以下数据:

    参数 参数说明
    availableBandwidth 可用网络带宽预估,单位为 Kbps。
    jitter 网络抖动,单位为毫秒 (ms)。
    packetLossRate 丢包率。
  4. 停止探测。

    探测过程中,若您需要停止探测,可以随时调用 stopLastmileProbeTest 方法停止通话前网络质量探测。

    示例代码如下:

    [[NERtcEngine sharedEngine] stopLastmileProbeTest];
    

API 参考

方法 功能描述
startLastmileProbeTest 开始网络质量探测。
stopLastmileProbeTest 停止网络质量探测。
事件 事件描述
onNERtcEngineLastmileQuality 网络质量探测打分结果。
onNERtcEngineLastmileProbeTestResult 网络质量探测报告。
此文档是否对你有帮助?
有帮助
去反馈
  • 功能介绍
  • 注意事项
  • 示例项目源码
  • API 调用时序
  • 实现方法
  • API 参考