音频设备管理

  • Android

更新时间不可用

getAudioDeviceInfo

获取音频设备信息。

Java
public abstract DeviceInfo getAudioDeviceInfo();

注: 你可以在加入频道前或加入频道后调用该方法。

返回值

方法调用成功,返回 DeviceInfo 对象。 方法调用失败,返回 null。

所属接口类

startPlaybackDeviceTest

启动本地音频播放设备测试。

Java
public abstract int startPlaybackDeviceTest(String audioFileName);

调用该方法后,SDK 会播放你指定的音频文件。如果你能听到音频,说明播放设备工作正常。调用该方法后,SDK 每 100 毫秒触发一次 onAudioVolumeIndication 回调,报告 uid 为 1 的播放设备音量信息。该方法与 startEchoTest 的区别在于,startPlaybackDeviceTest 仅检测本地音频播放设备是否正常,而 startEchoTest 可同时检测音视频设备和网络状况。

注: 请在加入频道前调用该方法。测试完成后,请在加入频道前调用 stopPlaybackDeviceTest 停止测试。

参数

参数名描述
audioFileName

音频文件的路径,UTF-8 编码的字符串。支持的文件格式包括:wav、mp3、m4a 和 aac。支持的采样率包括:8000、16000、32000、44100 和 48000 Hz。

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

返回值

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

所属接口类

startRecordingDeviceTest

启动音频采集设备测试。

Java
public abstract int startRecordingDeviceTest(int indicationInterval);

调用该方法后,SDK 会按照设置的时间间隔触发 onAudioVolumeIndication 回调,报告 uid = 0 以及采集设备的音量信息。该方法与 startEchoTest 的区别在于,startRecordingDeviceTest 仅检测本地音频采集设备是否正常工作,而 startEchoTest 可同时检测音视频设备和网络状况。

注: 请在加入频道前调用该方法。测试完成后,在加入频道前调用 stopRecordingDeviceTest 停止测试。

参数

参数名描述
indicationInterval

触发 onAudioVolumeIndication 回调的时间间隔(毫秒)。该值应大于 10,否则将无法收到 onAudioVolumeIndication 回调,且 SDK 返回错误码 -2。建议设置为 100。

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

返回值

  • 0:方法调用成功。

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

    • -2:参数无效,请检查参数设置。

所属接口类

stopPlaybackDeviceTest

停止音频播放设备测试。

Java
public abstract int stopPlaybackDeviceTest();

你需要在调用 startPlaybackDeviceTest 后调用该方法以停止测试。

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

返回值

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

所属接口类

stopRecordingDeviceTest

停止音频采集设备测试。

Java
public abstract int stopRecordingDeviceTest();

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

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

返回值

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

所属接口类