功能描述

为保证通话或直播质量,我们推荐在进入频道前进行音视频设备测试,检测麦克风、摄像头等音视频设备能否正常工作。该功能对于有高质量要求的场景,如在线教育等,尤为适用。

Agora 通过一个 startEchoTest 方法,支持用户在加入频道前,启动语音通话测试。该测试目的是测试系统的音频设备(耳麦、扬声器等)和网络连接是否正常。本文介绍如何使用该方法在项目中进行音频设备检测。

实现方法

请确保你已经了解如何实现音视频通话实现互动直播

  1. 在加入频道前,调用 startEchoTest 方法。调用该方法时,你需要设置一个 intervalInSeconds 参数,表示获取本次测试结果的间隔时间。该参数单位为秒,取值范围为 [2, 10],默认值为 10。

  2. 成功调用 startEchoTest 方法后,引导用户先说一段话,如果声音在设置的时间间隔后回放出来,且用户能听到自己刚才说的话,则表示系统音频设备和网络连接都是正常的。

  3. 获取音频设备测试结果后,调用 stopEchoTest 方法停止语音通话检测,然后你可以调用 joinChannel 加入频道。

示例代码

// 开启回声测试
rtcEngine.startEchoTest(10);

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

// 停止测试
rtcEngine.stopEchoTest();

API 参考

开发注意事项

  • 调用 startEchoTest 后必须调用 stopEchoTest 以结束测试,否则不能进行下一次回声测试,或者调用 joinChannel 进行通话。
  • 直播场景下,startEchoTest 仅能由用户角色为主播的用户调用。