通话前网络质量探测

更新时间: 2024/09/18 16:26:13

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

功能介绍

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

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

基本原理图如下:

网络质量探测.png

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

注意事项

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

API 调用时序

实现方法

  1. 注册探测回调监听。

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

    示例代码如下:

    //开始通话前网络质量探测
    nertc::NERtcLastmileProbeConfig probe_config;
    probe_config.probe_uplink = true;
    probe_config.probe_downlink = true;
    probe_config.expected_uplink_bitratebps = 100000;
    probe_config.expected_downlink_bitratebps = 100000;
    int res = rtc_engine_->startLastmileProbeTest(probe_config);
    
    //停止通话前网络质量探测
    int res = rtc_engine_->stopLastmileProbeTest();
    
    //注册回调 *.h
    class NRTCEngine : public nertc::IRtcEngineEventHandlerEx
    {
    public:
        RtcEngineEventHandlerEx();
        ~RtcEngineEventHandlerEx();
    public:
         ... 
        virtual void onLastmileQuality(nertc::NERtcNetworkQualityType quality) override;
        virtual void onLastmileProbeResult(const nertc::NERtcLastmileProbeResult& result) override;
    }
    nertc::NERtcEngineContext rtc_engine_context;
    ... //其他字段赋值
    rtc_engine_context.event_handler = new RtcEngineEventHandlerEx();
    rtc_engine_->initialize(rtc_engine_context)
    
    //通话前网络上下行 last mile 质量状态回调
    void NRTCEngine::onLastmileQuality(nertc::NERtcNetworkQualityType quality){
        std::cout << quality << std::endl;
    }
    
    void NRTCEngine::onLastmileProbeResult(const nertc::NERtcLastmileProbeResult& result){
        std::cout << result << std::endl;
    }
    
    
  2. 在加入房间前,调用 startLastmileProbeTest 方法进行网络质量探测,并通过 NERtcLastmileProbeConfig 结构体设置是否探测上行或下行网络以及对应的期望码率,相关参数的说明如下表所示。

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

    示例代码如下:

    NERtcLastmileProbeConfig probe_config;
    probe_config.probe_uplink = true;//是否开启上行探测;
    probe_config.probe_downlink = true;//是否开启下行探测;
    probe_config.expected_uplink_bitratebps = 100000;//预期最高发送探测码率;
    probe_config.expected_downlink_bitratebps = 100000;//预期最高接收码率;
    rtc_engine_->startLastmileProbeTest(probe_config); 
    
  3. 成功调用探测方法后,测速结果将在 onLastmileQualityonLastmileProbeResult 回调中返回。

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

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

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

    探测过程中(还未返回探测结果的两个回调),若您需要停止探测,可以随时调用 stopLastmileProbeTest 方法停止通话前网络质量探测。

    示例代码如下:

    rtc_engine_->stopLastmileProbeTest();
    

API 参考

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