HarmonyOS 鸿蒙Next应用在有其它应用后台播放音乐时，如何正确选择音频流类型

问题背景

有其他应用在后台播放音乐时，开发者需要根据应用场景指定音频流的StreamUsage，如果配置了不正确的StreamUsage，可能带来一些不符合预期的行为。例如以下场景：

导航场景错误使用STREAM_USAGE_MUSIC类型，导航应用播报时候会导致正在播放的音乐停止播放，而导航场景通常期望正在播放的音乐仅仅降低音量播放。

实现方案

开发者需要了解音频流类型对音频焦点管理的影响，然后根据自身的业务场景和实际需求，为音频选择合适的流类型。

例如有其他应用在后台播放音乐时，可参考下表进行选择：

设置音频流类型

AudioRenderer(ArkTS)

在调用createAudioRenderer接口时，传入对应的StreamUsage。

let audioRendererInfo: audio.AudioRendererInfo = {
usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION,
rendererFlags: 0
};
let audioRendererOptions: audio.AudioRendererOptions = {
streamInfo: audioStreamInfo,
rendererInfo: audioRendererInfo
};
audio.createAudioRenderer(audioRendererOptions, (err, data) => {
})

注：AudioRendererOptions中包含AudioRendererInfo，AudioRendererInfo中包含StreamUsage参数。

OHAudio(C/C++)

在调用OH_AudioStreamBuilder_SetRendererInfo接口时，传入对应的OH_AudioStream_Usage。

OH_AudioStreamBuilder_SetRendererInfo(builder, AUDIOSTREAM_USAGE_MUSIC);

AVPlayer(ArkTS)

通过设置属性audioRendererInfo中的usage来设置音频播放流类型。

avPlayer.on(‘stateChange’, async (state: string, reason: media.StateChangeReason) => {
switch (state) {
case ‘initialized’: // avplayer 设置播放源后触发该状态上报 
console.info(‘AVPlayer state initialized called.’);
this.avPlayer.audioRendererInfo = {
usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
rendererFlags: 0
}
avPlayer.prepare();
break;
}
}) 

注：在设置AVPlayer的audioRendererInfo属性时，只允许在initialized状态下设置。若应用没有主动设置该属性，AVPlayer会根据媒体源是否包含视频，使用Music或Movie作为usage的默认值。

AVPlayer(C/C++)

在调用OH_AVPlayer_SetAudioRendererInfo接口时，传入对应的OH_AudioStream_Usage。

OH_AVPlayer_SetAudioRendererInfo(player, AUDIOSTREAM_USAGE_MUSIC);

SoundPool(ArkTS)

在调用createSoundPool接口时，传入对应的StreamUsage。

// audioRenderInfo中的参数usage取值为STREAM_USAGE_UNKNOWN，STREAM_USAGE_MUSIC，STREAM_USAGE_MOVIE，// STREAM_USAGE_AUDIOBOOK时，SoundPool播放短音时为混音模式，不会打断其他音频播放。 
let audioRendererInfo: audio.AudioRendererInfo = {
usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
rendererFlags: 0
}
soundPool = await media.createSoundPool(5, audioRendererInfo);