1# 分布式音频播放（仅对系统应用开放） 2 3通过分布式音频播放的能力，用户可以将音频投播远端设备播放，实现音频在组网中不同设备之间流转。 4 5开发者可以通过分布式音频播放，将当前设备播放的所有音频投放到指定的远端设备播放，或将设备播放的某个音频流投放到指定的远端设备播放。 6 7## 开发步骤及示例 8 9在将音频投播到组网内其他设备前，需要先获取组网内的设备列表，并监听设备连接状态的变化，具体开发步骤请参考[音频输出设备管理](audio-output-device-management.md)。 10 11在获取组网内的设备列表时，可以通过指定DeviceFlag，筛选出需要的设备。 12 13| 名称 | 说明 | 14| -------- | -------- | 15| NONE_DEVICES_FLAG<sup>9+</sup> | 无。此接口为系统接口。 | 16| OUTPUT_DEVICES_FLAG | 本地输出设备。 | 17| INPUT_DEVICES_FLAG | 本地输入设备。 | 18| ALL_DEVICES_FLAG | 本地输入输出设备。 | 19| DISTRIBUTED_OUTPUT_DEVICES_FLAG<sup>9+</sup> | 分布式输出设备。 此接口为系统接口。 | 20| DISTRIBUTED_INPUT_DEVICES_FLAG<sup>9+</sup> | 分布式输入设备。 此接口为系统接口。 | 21| ALL_DISTRIBUTED_DEVICES_FLAG<sup>9+</sup> | 分布式输入输出设备。 此接口为系统接口。 | 22 23具体接口说明请参考[AudioRoutingManager API文档](../reference/apis/js-apis-audio.md#audioroutingmanager9)。 24 25### 投播所有音频 26 271. [获取输出设备信息](audio-output-device-management.md#获取输出设备信息)。 28 292. 创建AudioDeviceDescriptor对象，用于指定音频输出设备。 30 313. 调用selectOutputDevice，将当前设备播放的所有音频投放到指定的远端设备播放。 32 33```ts 34let outputAudioDeviceDescriptor = [{ 35 deviceRole: audio.DeviceRole.OUTPUT_DEVICE, 36 deviceType: audio.DeviceType.SPEAKER, 37 id: 1, 38 name: "", 39 address: "", 40 sampleRates: [44100], 41 channelCounts: [2], 42 channelMasks: [0], 43 networkId: audio.LOCAL_NETWORK_ID, 44 interruptGroupId: 1, 45 volumeGroupId: 1, 46}]; 47 48async function selectOutputDevice() { 49 audioRoutingManager.selectOutputDevice(outputAudioDeviceDescriptor, (err) => { 50 if (err) { 51 console.error(`Invoke selectOutputDevice failed, code is ${err.code}, message is ${err.message}`); 52 } else { 53 console.info('Invoke selectOutputDevice succeeded.'); 54 } 55 }); 56} 57``` 58 59### 投播指定音频流 60 611. [获取输出设备信息](audio-output-device-management.md#获取输出设备信息)。 62 632. 创建AudioRendererFilter对象，通过uid指定应用，通过rendererId指定音频流。 64 653. 创建AudioDeviceDescriptor对象，用于指定音频输出设备。 66 674. 调用selectOutputDeviceByFilter，将当前设备播放的指定音频流投放到指定的远端设备播放。 68 69```ts 70let outputAudioRendererFilter = { 71 uid: 20010041, 72 rendererInfo: { 73 content: audio.ContentType.CONTENT_TYPE_MUSIC, 74 usage: audio.StreamUsage.STREAM_USAGE_MEDIA, 75 rendererFlags: 0 }, 76 rendererId: 0 }; 77 78let outputAudioDeviceDescriptor = [{ 79 deviceRole: audio.DeviceRole.OUTPUT_DEVICE, 80 deviceType: audio.DeviceType.SPEAKER, 81 id: 1, 82 name: "", 83 address: "", 84 sampleRates: [44100], 85 channelCounts: [2], 86 channelMasks: [0], 87 networkId: audio.LOCAL_NETWORK_ID, 88 interruptGroupId: 1, 89 volumeGroupId: 1, 90}]; 91 92async function selectOutputDeviceByFilter() { 93 audioRoutingManager.selectOutputDeviceByFilter(outputAudioRendererFilter, outputAudioDeviceDescriptor, (err) => { 94 if (err) { 95 console.error(`Invoke selectOutputDeviceByFilter failed, code is ${err.code}, message is ${err.message}`); 96 } else { 97 console.info('Invoke selectOutputDeviceByFilter succeeded.'); 98 } 99 }); 100} 101``` 102