enableLastmileTest method Null safety

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');
}