startHardwareEchoDetection abstract method

Future<int?> startHardwareEchoDetection(
  1. String testAudioFilePath
)

开启通话前回声检测

v3.51 新增。

testAudioFilePath：用于回声检测的音频文件的绝对路径，路径字符串使用 UTF-8 编码格式，支持以下音频格式：mp3，aac，m4a，3gp，wav。
音频文件不为静音文件，推荐时长为 10 ～ 20 秒。

方法调用结果：

  • 0：成功。
  • -1：失败。上一次检测未结束，请先调用 stopHardwareEchoDetection 停止检测后重新调用本接口。
  • -2：失败。路径不合法或音频文件格式不支持。

注意：

  • 只有当 RoomProfile 为 meeting 和 meetingroom 时支持开启本功能。
  • 开启检测前，你需要向用户获取音频设备的使用权限。
  • 开启检测前，请确保音频设备没有被静音，采集和播放音量正常。
  • 调用本接口后监听 RTCVideoEventHandler.onHardwareEchoDetectionResult 获取检测结果。
  • 检测期间，进程将独占音频设备，无法使用 startEchoTest。
  • 调用 stopHardwareEchoDetection 停止检测，释放对音频设备的占用。

Implementation

Future<int?> startHardwareEchoDetection(String testAudioFilePath);