音频设备管理

getAudioDeviceInfo

获取音频设备信息。

Java

public abstract DeviceInfo getAudioDeviceInfo();

信息

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

返回值

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

所属接口类

• RtcEngine

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：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• RtcEngine

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：参数无效，请检查参数设置。

所属接口类

• RtcEngine

stopPlaybackDeviceTest

停止音频播放设备测试。

Java

public abstract int stopPlaybackDeviceTest();

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

信息

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

返回值

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

所属接口类

• RtcEngine

stopRecordingDeviceTest

停止音频采集设备测试。

Java

public abstract int stopRecordingDeviceTest();

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

信息

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

返回值

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

所属接口类

• RtcEngine