分布式音频播放(仅对系统应用开放)
通过分布式音频播放的能力,用户可以将音频投播远端设备播放,实现音频在组网中不同设备之间流转。
开发者可以通过分布式音频播放,将当前设备播放的所有音频投放到指定的远端设备播放,或将设备播放的某个音频流投放到指定的远端设备播放。
开发步骤及示例
在将音频投播到组网内其他设备前,需要先获取组网内的设备列表,并监听设备连接状态的变化,具体开发步骤请参考音频输出设备管理。
在获取组网内的设备列表时,可以通过指定DeviceFlag,筛选出需要的设备。
名称 | 说明 |
---|---|
NONE_DEVICES_FLAG9+ | 无。此接口为系统接口。 |
OUTPUT_DEVICES_FLAG | 本地输出设备。 |
INPUT_DEVICES_FLAG | 本地输入设备。 |
ALL_DEVICES_FLAG | 本地输入输出设备。 |
DISTRIBUTED_OUTPUT_DEVICES_FLAG9+ | 分布式输出设备。 此接口为系统接口。 |
DISTRIBUTED_INPUT_DEVICES_FLAG9+ | 分布式输入设备。 此接口为系统接口。 |
ALL_DISTRIBUTED_DEVICES_FLAG9+ | 分布式输入输出设备。 此接口为系统接口。 |
具体接口说明请参考AudioRoutingManager API文档。
投播所有音频
-
创建AudioDeviceDescriptor对象,用于指定音频输出设备。
-
调用selectOutputDevice,将当前设备播放的所有音频投放到指定的远端设备播放。
let outputAudioDeviceDescriptor = [{
deviceRole: audio.DeviceRole.OUTPUT_DEVICE,
deviceType: audio.DeviceType.SPEAKER,
id: 1,
name: "",
address: "",
sampleRates: [44100],
channelCounts: [2],
channelMasks: [0],
networkId: audio.LOCAL_NETWORK_ID,
interruptGroupId: 1,
volumeGroupId: 1,
}];
async function selectOutputDevice() {
audioRoutingManager.selectOutputDevice(outputAudioDeviceDescriptor, (err) => {
if (err) {
console.error(`Invoke selectOutputDevice failed, code is ${err.code}, message is ${err.message}`);
} else {
console.info('Invoke selectOutputDevice succeeded.');
}
});
}
投播指定音频流
-
创建AudioRendererFilter对象,通过uid指定应用,通过rendererId指定音频流。
-
创建AudioDeviceDescriptor对象,用于指定音频输出设备。
-
调用selectOutputDeviceByFilter,将当前设备播放的指定音频流投放到指定的远端设备播放。
let outputAudioRendererFilter = {
uid: 20010041,
rendererInfo: {
content: audio.ContentType.CONTENT_TYPE_MUSIC,
usage: audio.StreamUsage.STREAM_USAGE_MEDIA,
rendererFlags: 0 },
rendererId: 0 };
let outputAudioDeviceDescriptor = [{
deviceRole: audio.DeviceRole.OUTPUT_DEVICE,
deviceType: audio.DeviceType.SPEAKER,
id: 1,
name: "",
address: "",
sampleRates: [44100],
channelCounts: [2],
channelMasks: [0],
networkId: audio.LOCAL_NETWORK_ID,
interruptGroupId: 1,
volumeGroupId: 1,
}];
async function selectOutputDeviceByFilter() {
audioRoutingManager.selectOutputDeviceByFilter(outputAudioRendererFilter, outputAudioDeviceDescriptor, (err) => {
if (err) {
console.error(`Invoke selectOutputDeviceByFilter failed, code is ${err.code}, message is ${err.message}`);
} else {
console.info('Invoke selectOutputDeviceByFilter succeeded.');
}
});
}