音频设备管理

  • HarmonyOS

更新时间不可用

介绍跟音频设备管理相关的方法和回调。

startRecordingDeviceTest

启动音频采集设备测试。

TypeScript
public abstract startRecordingDeviceTest(indicationInterval:number):number;

详情

该方法用于测试本地音频采集设备是否能正常工作。调用该方法后,SDK 会按设置的时间间隔触发 onAudioVolumeIndication 回调,报告 uid = 0 及采集设备的音量信息。

该方法和 startEchoTest 的区别在于该方法检测本地的音频采集设备能否正常工作,后者可以检测音视频设备及网络是否正常。

注: 该方法需要在加入频道前调用。测试完成后,如需加入频道,请确保先调用 stopRecordingDeviceTest 停止设备测试。

参数

参数名描述
indicationInterval

SDK 触发 onAudioVolumeIndication 回调的时间间隔,单位为毫秒,最小取值为 10,否则会收不到 onAudioVolumeIndication 回调,SDK 会返回错误码 -2。声网推荐你将该值设为 100。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。

  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

    • -2: 参数设置错误,请重新设置参数。

stopRecordingDeviceTest

停止音频采集设备测试。

TypeScript
public abstract stopRecordingDeviceTest():number;

详情

该方法用于停止音频采集设备测试。调用 startRecordingDeviceTest 后,必须调用该方法停止测试。

注: 该方法需要在加入频道前调用。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。