通话前检测

在对音视频质量要求较高的场景下，需要在通话前进行检测，以确保设备的运转状态良好、设备与声网平台之间的网络状态正常。 此操作能够提前识别并排除潜在的故障，从而改善用户体验。

本文介绍如何在 App 中实施网络和设备检测。

技术原理

在通信场景中，可通过检测了解网络状态。 例如，简单发送一条空消息以查看目标地址是否存在。

进行网络检测时需要重点关注以下指标：

• 带宽：通常以 bit/s 为单位，表示信息传输的最大速率
• 吞吐量： 信息传输的实际速率
• 时延： 信息从发送方到接收方所需要的时间，包括接收方的解码时间，以及每一个网络节点进行数据处理的时间
• 抖动： 接收方收到数据包的延迟变化
• 错误率： 以百分比或分数表示损坏的信息占发送信息总数的比例

进行设备检测可以保证设备获取的音频在经过网络传输后可以正常播放。 首先，声网会从设备的麦克风获取音频，然后将其发送到声网平台，并定义一个等待时间（例如：5 秒）。 等待时间过后，声网平台将音频发送回设备，并在设备扬声器中播放。 然后，你可以判断音频的质量是否良好。

声网建议你先进行设备测试，然后进行网络检测。

设备检测

SDK 提供了 startEchoTest 方法，用于测试网络连接和音频设备（如麦克风和扬声器）是否正常工作。

网络检测

SDK 提供了startLastmileProbeTest 方法，用于在加入频道之前探测 last mile 网络质量，并返回有关网络质量的统计信息，包括往返时延、丢包率和网络带宽。

各 API 的调用时序如下：

前提条件

在进行操作之前，请确保你已在 App 中实现了基本的实时音视频功能。 请参考实现音视频互动。

操作步骤

参考以下步骤在 App 中实施通话前检测。

设备检测

请参考以下步骤进行设备检测。

1. 在加入频道前，调用 startEchoTest。 你需要在该方法中设置 intervalInSeconds 参数，用于通知 SDK 何时上报本次测试的结果。 取值范围为 [2~10]，默认值为 10（单位：秒）。
2. 当回声测试开始后，引导用户说一句话。 如果在设置的时间间隔后播放录音，则表示音频设备和网络连接正常。
3. 获得测试结果后，调用 stopEchoTest 停止测试，然后再调用 joinChannel 加入频道。

进行设备测试的示例代码如下所示。

Java

// 开始回声测试
// 设置参数为10，表示开始说话10秒后开始播放录到的声音
// 只有主播才能调用 startEchoTest
rtcEngine.startEchoTest(10);

// 等待并检查是否可以听到自己的声音回放

// 停止回声测试
// 必须调用 stopEchoTest 结束回声测试。 否则，你将无法进行另一次回声测试，或使用 joinChannel 加入频道
rtcEngine.stopEchoTest();

网络检测

请参考以下步骤进行网络检测。

1. 在加入频道或切换用户角色之前，调用 startLastmileProbeTest 启动网络检测。 你需要在此方法中设置你预期的上行和下行比特率。
2. 调用该方法后，SDK 会触发以下回调：
   • onLastmileQuality：在调用 startLastmileProbeTest 方法两秒后触发。 该回调通过打分反馈上下行网络质量，更贴近主观感受。
   • onLastmileProbeResult：在调用 startLastmileProbeTest 方法 30 秒后触发。 该回调返回网络状况的实时统计数据，更加客观。
3. 获取网络质量统计信息后，调用 stopLastmileProbeTest 方法停止 last mile 网络检测。

请参考以下代码实现 last mile 网络测试。

Java

// 配置 LastmileProbeConfig 实例
LastmileProbeConfig config = new LastmileProbeConfig(){};
// 检测上行网络质量
config.probeUplink = true;
// 检测下行网络质量
config.probeDownlink = true;
// 预期的上行比特率 (bps)。 取值范围为 [100000,5000000]
config.expectedUplinkBitrate = 100000;
// 预期的下行比特率 (bps)。 取值范围为 [100000,5000000]
config.expectedDownlinkBitrate = 100000;
// 加入频道前开始 last mile 网络测试
// 调用 startLastmileProbeTest 进行通话前网络质量检测会消耗网络流量。 因此，在调用该方法后，声网建议你在收到 onLastmileProbeResult 回调之前不要调用任何其他方法
rtcEngine.startLastmileProbeTest(config);

// 在全局 IRtcEngineEventHandler 类中实现
// 在开始 last mile 测试后 2 秒触发
// onLastmileQuality 回调在第一次触发时可能会返回 UNKNOWN。 后续的回调将返回测试结果
public void onLastmileQuality(int quality){
    statisticsInfo.setLastMileQuality(quality);
    updateLastMileResult();
}


// 在全局 IRtcEngineEventHandler 类中实现
// 在开始 Last mile 测试 30 秒后触发
public void onLastmileProbeResult(LastmileProbeResult) {
	// (1) 在回调内部停止测试。声网建议在测试结束前不要调用任何其他 API
	rtcEngine.stopLastmileProbeTest();
    statisticsInfo.setLastMileProbeResult(lastmileProbeResult);
    updateLastMileResult();
}

// (2) 也可以选择在其他时候停止测试。声网建议在测试结束前不要调用任何其他 API
rtcEngine.stopLastmileProbeTest();

参考信息

介绍本文中使用方法的更多信息以及相关页面的链接。

示例项目

声网在 GitHub 上提供已实现了通话前检测的开源示例项目。 你可以下载体验或查看其中的源代码。

API 参考

• startLastmileProbeTest
• stopLastmileProbeTest
• onLastmileQuality
• onLastmileProbeResult
• startEchoTest
• stopEchoTest