1# 音频输出设备管理 2 3有时设备同时连接多个音频输出设备，需要指定音频输出设备进行音频播放，此时需要使用AudioRoutingManager接口进行输出设备的管理，API说明可以参考[AudioRoutingManager API文档](../reference/apis/js-apis-audio.md#audioroutingmanager9)。 4 5## 创建AudioRoutingManager实例 6 7在使用AudioRoutingManager管理音频设备前，需要先导入模块并创建实例。 8 9```ts 10import audio from '@ohos.multimedia.audio'; // 导入audio模块 11 12let audioManager = audio.getAudioManager(); // 需要先创建AudioManager实例 13 14let audioRoutingManager = audioManager.getRoutingManager(); // 再调用AudioManager的方法创建AudioRoutingManager实例 15``` 16 17## 支持的音频输出设备类型 18 19目前支持的音频输出设备见下表： 20 21| 名称 | 值 | 说明 | 22| -------- | -------- | -------- | 23| EARPIECE | 1 | 听筒。 | 24| SPEAKER | 2 | 扬声器。 | 25| WIRED_HEADSET | 3 | 有线耳机，带麦克风。 | 26| WIRED_HEADPHONES | 4 | 有线耳机，无麦克风。 | 27| BLUETOOTH_SCO | 7 | 蓝牙设备SCO（Synchronous Connection Oriented）连接。 | 28| BLUETOOTH_A2DP | 8 | 蓝牙设备A2DP（Advanced Audio Distribution Profile）连接。 | 29| USB_HEADSET | 22 | USB耳机，带麦克风。 | 30 31## 获取输出设备信息 32 33使用getDevices()方法可以获取当前所有输出设备的信息。 34 35```ts 36audioRoutingManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data) => { 37 console.info('Promise returned to indicate that the device list is obtained.'); 38}); 39``` 40 41## 监听设备连接状态变化 42 43可以设置监听事件来监听设备连接状态的变化，当有设备连接或断开时触发回调： 44 45```ts 46// 监听音频设备状态变化 47audioRoutingManager.on('deviceChange', audio.DeviceFlag.OUTPUT_DEVICES_FLAG, (deviceChanged) => { 48 console.info('device change type : ' + deviceChanged.type); // 设备连接状态变化，0为连接，1为断开连接 49 console.info('device descriptor size : ' + deviceChanged.deviceDescriptors.length); 50 console.info('device change descriptor : ' + deviceChanged.deviceDescriptors[0].deviceRole); // 设备角色 51 console.info('device change descriptor : ' + deviceChanged.deviceDescriptors[0].deviceType); // 设备类型 52}); 53 54// 取消监听音频设备状态变化 55audioRoutingManager.off('deviceChange', (deviceChanged) => { 56 console.info('Should be no callback.'); 57}); 58``` 59 60## 选择音频输出设备（仅对系统应用开放） 61 62选择音频输出设备，当前只能选择一个输出设备，以设备ID作为唯一标识。AudioDeviceDescriptors的具体信息可以参考[AudioDeviceDescriptors](../reference/apis/js-apis-audio.md#audiodevicedescriptors)。 63 64> **说明：** 65> 66> 用户可以选择连接一组音频设备（如一对蓝牙耳机），但系统侧只感知为一个设备，该组设备共用一个设备ID。 67 68```ts 69let outputAudioDeviceDescriptor = [{ 70 deviceRole : audio.DeviceRole.OUTPUT_DEVICE, 71 deviceType : audio.DeviceType.SPEAKER, 72 id : 1, 73 name : "", 74 address : "", 75 sampleRates : [44100], 76 channelCounts : [2], 77 channelMasks : [0], 78 networkId : audio.LOCAL_NETWORK_ID, 79 interruptGroupId : 1, 80 volumeGroupId : 1, 81}]; 82 83async function selectOutputDevice(){ 84 audioRoutingManager.selectOutputDevice(outputAudioDeviceDescriptor).then(() => { 85 console.info('Invoke selectOutputDevice succeeded.'); 86 }).catch((err) => { 87 console.error(`Invoke selectOutputDevice failed, code is ${err.code}, message is ${err.message}`); 88 }); 89} 90``` 91