在对音视频质量要求较高的场景下,需要在通话前进行检测,以确保设备的运转状态良好、设备与声网平台之间的网络状态正常。 此操作能够提前识别并排除潜在的故障,从而改善用户体验。
本文介绍如何在 app 中实施网络和设备检测。
在通信场景中,可通过检测了解网络状态。 例如,简单发送一条空消息以查看目标地址是否存在。
进行网络检测时需要重点关注以下指标:
进行设备检测可以保证设备获取的音频在经过网络传输后可以正常播放。 首先,声网会从设备的麦克风获取音频,然后将其发送到声网平台,并定义一个等待时间(例如:5 秒)。 等待时间过后,声网平台将音频发送回设备,并在设备扬声器中播放。 然后,你可以判断音频的质量是否良好。
声网建议你先进行设备测试,然后进行网络检测。
SDK 提供了startEchoTest
方法,用于测试网络连接和音频设备(例如麦克风和扬声器)是否正常工作。
SDK 提供了 startLastmileProbeTest
方法,用于在加入频道前检测 last mile 网络并返回有关网络质量的统计信息,包括往返时延、丢包率和网络带宽。
在进行 last mile 检测时,视频 SDK 根据视频配置文件调整实际比特率。
在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。 有关详细信息,请参考实现视频通话或实现视频直播。
请参考以下步骤在 app 中实施通话前检测。
测试系统的音频设备和网络连接是否正常,请参考以下步骤。
startEchoTest
。 你需要在该方法中设置 intervalInSeconds
参数来通知 SDK 何时上报本次测试的结果。 取值范围为 [2~10],默认值为 10(单位:秒)。stopEchoTest
停止测试,再调用 joinChannelByToken
加入频道。请参考以下示例代码来实现该功能。
this.engine.startEchoTest(10);
this.engine.stopEchoTest();
请参考以下步骤进行网络检测。
startLastmileProbeTest
启动网络检测。 你需要在此方法中设置你预期的上行和下行比特率。onLastmileQuality
:在调用 startLastmileProbeTest
2 秒后返回。 该回调通过打分反馈上下行网络质量,更贴近主观感受。onLastmileProbeResult
:在调用 startLastmileProbeTest
30 秒后返回。 该回调提了网络质量的实时统计数据,更加客观。stopLastmileProbeTest
停止网络检测。this.engine.registerEventHandler({
onLastmileQuality(quality: QualityType) {},
onLastmileProbeResult(result: LastmileProbeResult) {},
});
this.engine.startLastmileProbeTest({
probeUplink: true,
probeDownlink: true,
expectedUplinkBitrate: 100000,
expectedDownlinkBitrate: 100000,
});
this.engine.stopLastmileProbeTest();
介绍本文中使用方法的更多信息以及相关页面的链接。
我们在 GitHub 上提供已实现调整采集、播放、耳返音量的开源示例项目 JoinChannelAudio。你可以下载体验并参考源代码。
实现调整通话音量过程中,你还可以参考如下文档: