功能描述
anyRTC 提供了通话前网络和设备检测的功能,方便你进行音视频通话时,保证通信顺畅。通话前检测从两个角度开展:
-
网络质量检测:通过检测当前网络质量的上下行,从而判断用户当前的网络质量是否良好。
-
设备质量检测:检测摄像头是否正常工作、检测音频设备是否正常录音及播放、设置摄像头方向或者切换音频设备(麦克风和扬声器)等。
网络质量探测
RTC SDK 提供 startLastmileProbeTest
方法,可在开始通话前进行网络质量探测,向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。
实现方法
该功能需要在用户加入频道前实现,具体步骤流程如下:
-
调用
startLastmileProbeTest
进行网络质量探测,向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延。 -
启用该方法后,SDK 会依次返回如下 2 个回调:
-
onLastmileQuality
:约 2 秒内返回。该回调通过打分反馈上下行网络质量,更贴近主观感受 -
onLastmileProbeResult
:约 30 秒内返回。该回调通过客观数据反馈上下行网络质量,更客观
-
-
获取到网络质量数据后,调用
stopLastmileProbeTest
停止通话前网络质量检测。
如下是通话前网络质量检测图:
示例代码
参考下文示例代码在你的项目中进行通话前网络质量探测。
// 注册回调接口
// 开始 Last-mile 网络探测后,约 2 秒后发生该回调
void onLastmileQuality(int quality) {
}
// 开始 Last-mile 网络探测后,约 30 秒后发生该回调
void onLastmileProbeResult(LastmileProbeResult) {
// (1)可以选择在回调内部结束测试。在测试结束前,anyRTC 建议不要调用其他 API 方法
lpArEngine->stopLastmileProbeTest();
}
// 配置一个 LastmileProbeConfig 实例
LastmileProbeConfig config;
// 确认探测上行网络质量
config.probeUplink = true;
// 确认探测下行网络质量
config.probeDownlink = true;
// 期望的最高发送码率,单位为 bps,范围为 [100000,5000000]
config.expectedUplinkBitrate = 100000;
// 期望的最高接收码率,单位为 bps,范围为 [100000,5000000]
config.expectedDownlinkBitrate = 100000;
// 加入频道前开始 Last-mile 网络探测
lpArEngine->startLastmileProbeTest(config);
// (2)也可以选择在其他时候结束测试。在测试结束前,anyRTC 建议不要调用其他 API 方法
lpArEngine->stopLastmileProbeTest();