startLastmileProbeTest method
- LastmileProbeConfig config
开始通话前网络质量探测,向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。
启用该方法后,SDK 会依次返回如下 2 个回调:
- RtcEngineEventHandler.lastmileQuality:视网络情况约 2 秒内返回。 该回调通过打分反馈上下行网络质量,更贴近用户的主观感受。
- RtcEngineEventHandler.lastmileProbeResult:视网络情况约 30 秒内返回。 该回调通过客观数据反馈上下行网络质量,因此更客观。
该方法主要用于以下两种场景:
- 用户加入频道前,可以调用该方法判断和预测目前的上行网络质量是否足够好。
- 直播场景下,当用户角色想由观众切换为主播时,可以调用该方法判断和预测目前的上行网络质量是否足够好。
Note
- 该方法会消耗一定的网络流量,影响通话质量,因此我们建议不要同时使用该方法和 RtcEngine.enableLastmileTest。
- 调用该方法后,在收到 RtcEngineEventHandler.lastmileQuality 和 RtcEngineEventHandler.lastmileProbeResult 回调之前请不用调用其他方法, 否则可能会由于 API 操作过于频繁导致此方法无法执行。
- 直播场景下,如果本地用户为主播,请勿在加入频道后调用该方法。
Parameter config
Last-mile 网络探测配置。详见 LastmileProbeConfig。
Implementation
@override
Future<void> startLastmileProbeTest(LastmileProbeConfig config) {
return _invokeMethod('startLastmileProbeTest', {'config': config.toJson()});
}