文档中心

实时音视频

请输入

设备检测

扬声器检测

检测扬声器设备（一般为 PC 端），以确定用户设备是否支持所需的音视频功能。对扬声器设备进行枚举与选择、音量调节与检测。

时序图

相关 API

功能点			Windows	MacOS
获取音频设备管理器			getAudioDeviceManager	getAudioDeviceManager
枚举扬声器	枚举设备	enumerateAudioPlaybackDevices	enumerateAudioPlaybackDevices
		获取设备数量	getCount	getCount
		获取设备	getDevice	getDevice:
		释放设备	release
切换扬声器	获取音频播放设备	getAudioPlaybackDevice	getAudioPlaybackDevice:
		设置音频播放路由不跟随系统	followSystemPlaybackDevice	followSystemPlaybackDevice:
		设置音频播放设备	setAudioPlaybackDevice	setAudioPlaybackDevice:
扬声器设备音量回调			onAudioDeviceVolumeChanged	onAudioDeviceVolumeChanged:
扬声器音量调节（采集的音量）			setPlaybackVolume	setPlaybackVolume:
扬声器测试	初始化音频播放设备	initAudioPlaybackDeviceForTest	initAudioPlaybackDeviceForTest:
		开始音频播放设备测试，循环播放指定音频文件	startAudioPlaybackDeviceTest	startAudioPlaybackDeviceTest:interval:
		停止音频播放设备测试	stopAudioPlaybackDeviceTest	stopAudioDevicePlayTest
扬声器测试音量回调			onAudioPlaybackDeviceTestVolume	onAudioPlaybackDeviceTestVolume:

常见问题

该部分介绍扬声器检测过程中的常见问题，关键词如下：

音频播放路由是否跟随系统

可以通过 followSystemPlaybackDevice 设置音频播放路由是否跟随系统。如果将该方法的参数设置为false，即设置音频播放路由不跟随系统，那么用户就可以手动切换扬声器设备；如果设置音频播放路由跟随系统，将无法调用 setAudioPlaybackDevice 设置音频播放设备。

设备检测前的异常问题检测

在扬声器检测前，调用 initAudioPlaybackDeviceForTest 可以检测设备不存在、权限被拒绝/禁用等异常问题。

音频播放测试

调用 startAudioPlaybackDeviceTest 可以进行扬声器检测，测试启动后，会循环播放指定的音频文件；调用 stopAudioPlaybackDeviceTest 可以停止音频播放测试。

音量回调

当扬声器系统音量发生变化，触发 onAudioDeviceVolumeChanged 回调。通过监听该回调，可以感知扬声器音量变化；如果设备音量过小或处于静音状态，可以根据需要给用户相应的提示。

设备权限配置

在 macOS 系统下，需在 Info.plist 文件中设置 NSMicrophoneUsageDescription；不更改 Windows 系统设置情况下，无需申请权限即可直接访问。

具体参考设备权限处理。

最近更新时间：2026.08.04 14:44:27

这个页面对您有帮助吗？

有用

无用