enableLastmileTest method

Future<void> enableLastmileTest ()

启用网络测试。

该方法启用网络连接质量测试，用于检测用户网络接入质量。默认该功能为关闭状态。该方法主要用于以下两种场景：

  • 用户加入频道前，可以调用该方法判断和预测目前的上行网络质量是否足够好。
  • 直播场景下，当用户角色想由观众切换为主播时，可以调用该方法判断和预测目前的上行网络质量是否足够好。 无论哪种场景，启用该方法会消耗一定的网络流量，影响通话质量。在收到 RtcEngineEventHandler.lastmileQuality 回调后 须调用 RtcEngine.disableLastmileTest 停止测试，再加入频道或切换用户角色。

Note

该方法请勿与 RtcEngine.startLastmileProbeTest 同时使用。

  • 调用该方法后，在收到 RtcEngineEventHandler.lastmileQuality 回调之前请不要调用其他方法， 否则可能会由于 API 操作过于频繁导致此回调无法执行。
  • 直播场景下，主播在加入频道后，请勿调用该方法。
  • 加入频道前调用该方法检测网络质量后，SDK 会占用一路视频的带宽，码率 与 RtcEngine.setVideoEncoderConfiguration 中设置的码率相同。加入频道后，无论是否调用了 RtcEngine.disableLastmileTest，SDK 均会自动停止带宽占用。

Implementation

@override
Future<void> enableLastmileTest() {
  return _invokeMethod('enableLastmileTest');
}