# 音频设备管理 (/zh-CN/api-reference/rtc/android/4.6.0/device-management/audio-device) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## getAudioDeviceInfo [#getaudiodeviceinfo] 获取音频设备信息。 ```java public abstract DeviceInfo getAudioDeviceInfo(); ``` :::info[注] 你可以在加入频道前或加入频道后调用该方法。 ::: ### 返回值 [#返回值] 方法调用成功,返回 [DeviceInfo](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-deviceinfo) 对象。 方法调用失败,返回 `null`。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine) ## startPlaybackDeviceTest [#startplaybackdevicetest] 启动本地音频播放设备测试。 ```java public abstract int startPlaybackDeviceTest(String audioFileName); ``` 调用该方法后,SDK 会播放你指定的音频文件。如果你能听到音频,说明播放设备工作正常。调用该方法后,SDK 每 100 毫秒触发一次 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调,报告 `uid` 为 1 的播放设备音量信息。该方法与 [startEchoTest](/zh-CN/api-reference/rtc/android/network-and-other#api_irtcengine_startechotest3) 的区别在于, [startPlaybackDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_startplaybackdevicetest) 仅检测本地音频播放设备是否正常,而 [startEchoTest](/zh-CN/api-reference/rtc/android/network-and-other#api_irtcengine_startechotest3) 可同时检测音视频设备和网络状况。 :::info[注] 请在加入频道前调用该方法。测试完成后,请在加入频道前调用 [stopPlaybackDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_stopplaybackdevicetest) 停止测试。 ::: ### 参数 [#参数] #### `audioFileName` [#audiofilename] 音频文件的路径,UTF-8 编码的字符串。支持的文件格式包括:wav、mp3、m4a 和 aac。支持的采样率包括:8000、16000、32000、44100 和 48000 Hz。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine) ## startRecordingDeviceTest [#startrecordingdevicetest] 启动音频采集设备测试。 ```java public abstract int startRecordingDeviceTest(int indicationInterval); ``` 调用该方法后,SDK 会按照设置的时间间隔触发 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调,报告 `uid` = 0 以及采集设备的音量信息。该方法与 [startEchoTest](/zh-CN/api-reference/rtc/android/network-and-other#api_irtcengine_startechotest3) 的区别在于, [startRecordingDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_startrecordingdevicetest) 仅检测本地音频采集设备是否正常工作,而 [startEchoTest](/zh-CN/api-reference/rtc/android/network-and-other#api_irtcengine_startechotest3) 可同时检测音视频设备和网络状况。 :::info[注] 请在加入频道前调用该方法。测试完成后,在加入频道前调用 [stopRecordingDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_stoprecordingdevicetest) 停止测试。 ::: ### 参数 [#参数-1] #### `indicationInterval` [#indicationinterval] 触发 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调的时间间隔(毫秒)。该值应大于 10,否则将无法收到 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调,且 SDK 返回错误码 -2。建议设置为 100。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 - -2:参数无效,请检查参数设置。 ### 所属接口类 [#所属接口类-2] - [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine) ## stopPlaybackDeviceTest [#stopplaybackdevicetest] 停止音频播放设备测试。 ```java public abstract int stopPlaybackDeviceTest(); ``` 你需要在调用 [startPlaybackDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_startplaybackdevicetest) 后调用该方法以停止测试。 :::info[注] 请在加入频道前调用该方法。 ::: ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine) ## stopRecordingDeviceTest [#stoprecordingdevicetest] 停止音频采集设备测试。 ```java public abstract int stopRecordingDeviceTest(); ``` 你必须在调用 [startRecordingDeviceTest](/zh-CN/api-reference/rtc/android/device-management/audio-device#api_irtcengine_startrecordingdevicetest) 后调用该方法以停止音频采集设备测试。 :::info[注] 请在加入频道前调用该方法。 ::: ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)