功能描述
为保证通话或直播质量,我们推荐在进入频道前进行音视频设备测试,检测麦克风、摄像头等音视频设备能否正常工作。该功能对于有高质量要求的场景,如在线教育等,尤为适用。
AR 通过一个 startEchoTest
方法,支持用户在加入频道前,启动语音通话测试。该测试目的是测试系统的音频设备(耳麦、扬声器等)和网络连接是否正常。本文介绍如何使用该方法在项目中进行音频设备检测。
实现方法
- 在加入频道前,调用
startEchoTest
方法。调用该方法时,你需要设置一个intervalInSeconds
参数,表示获取本次测试结果的间隔时间。该参数单位为秒,取值范围为 [2, 10],默认值为 10。 - 成功调用
startEchoTest
方法后,引导用户先说一段话,如果声音在设置的时间间隔后回放出来,且用户能听到自己刚才说的话,则表示系统音频设备和网络连接都是正常的。 - 获取音频设备测试结果后,调用
stopEchoTest
方法停止语音通话检测,然后你可以调用joinChannel
加入频道。
示例代码
// 开启回声测试
fun startEchoTest(params: Map<String, *>, callback: Callback)
// 停止测试
fun stopEchoTest(callback: Callback)
开发注意事项
- 调用
startEchoTest
后必须调用stopEchoTest
以结束测试,否则不能进行下一次回声测试,或者调用joinChannel
进行通话。 - 直播场景下,
startEchoTest
仅能由用户角色为主播的用户调用。