HarmonyOS 6学习：听书App被“误杀”？音频焦点与AudioSession共存避坑指南

在HarmonyOS 6上开发工具类应用（如计算器、翻译、广告页）时，你是否遇到过这种"背锅"场景：用户正在后台使用听书App（如喜马拉雅），当你打开你的应用播放一段提示音或广告视频时，听书声音直接被掐断，且应用退出后也无法恢复。用户投诉"XX应用一打开就杀我后台听书"，而你检查代码确认没有调用任何停止接口。

这并非你的应用"霸道"，而是HarmonyOS 6音频系统默认的"焦点抢占"机制在作祟 。本文将彻底解析这一"误杀"现象，并提供一套基于AudioSession与StreamUsage的完整"音频友好型"解决方案。

一、现象：无辜的"背锅侠"，被掐断的听书

1. 问题现场：我只是想播个提示音

场景复现 ：用户手机后台运行听书App（播放电子书流），此时打开你的工具应用（如计算器点击有音效，或启动页有广告视频）。听书声音立即中断，即使你退出应用，听书也无法自动恢复，必须用户手动点击播放。

预期效果	实际效果	用户感知
工具音效与听书共存（音量衰减）	❌ 听书被强制停止	"这个App一打开就杀我后台"

错误代码示例（导致"误杀"的元凶）：

复制代码

// ❌ 错误示例：默认配置（未处理音频焦点）
import audio from '@ohos.multimedia.audio';

// 应用启动时播放提示音或广告
async function playStartupSound() {
  let audioRenderer: audio.AudioRenderer | null = null;
  try {
    const streamInfo: audio.AudioStreamInfo = {
      samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
      channels: audio.AudioChannel.CHANNEL_2,
      sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
      encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
    };

    const rendererOptions: audio.AudioRendererOptions = {
      streamInfo: streamInfo,
      // 关键问题：默认使用MUSIC类型，系统认为你要"独占"音频
      streamUsage: audio.StreamUsage.STREAM_USAGE_MEDIA, // 默认媒体流
    };

    audioRenderer = await audio.createAudioRenderer(rendererOptions);
    await audioRenderer.start();
    // ... 写入音频数据
  } catch (err) {
    console.error('播放失败:', err.message);
  }
}

2. 根因揭秘：音频焦点的"丛林法则"

核心机制 ：HarmonyOS 6 采用音频焦点（Audio Focus） 机制管理多应用并发。当你的应用创建音频流时，系统会根据StreamUsage（流类型）决定如何对待正在播放的其他应用。

默认策略表（听书 vs 你的应用）：

听书流类型 (先播)	你的流类型 (后播)	系统默认行为	结果
STREAM_USAGE_MEDIA (电子书)	STREAM_USAGE_MEDIA (媒体)	Stop (终止)	❌ 听书被掐断
STREAM_USAGE_MEDIA	STREAM_USAGE_GAME (游戏)	Mix (并发)	✅ 听书继续
STREAM_USAGE_MEDIA	STREAM_USAGE_VOICE_MESSAGE (语音)	Pause (暂停)	⚠️ 听书暂停（可恢复）

失败本质 ：同类型媒体流默认是"敌人" 。当你的工具应用使用STREAM_USAGE_MEDIA播放音效时，系统认为"新的音乐来了，旧的音乐该停了"，从而强制终止听书App的播放流。

二、解决方案：做"友好"的音频参与者

1. 方案一：修改StreamUsage（推荐：简单有效）

核心思路 ：将你的音效/提示音**"降级"为游戏音效或语音消息**。系统认为游戏音效和语音消息优先级低于媒体流，不会强制终止听书。

修复代码：

复制代码

import audio from '@ohos.multimedia.audio';

async function playFriendlySound() {
  let audioRenderer: audio.AudioRenderer | null = null;
  try {
    const rendererOptions: audio.AudioRendererOptions = {
      streamInfo: { ... },
      // 关键修复：改为游戏或语音类型
      streamUsage: audio.StreamUsage.STREAM_USAGE_GAME, 
      // 或 audio.StreamUsage.STREAM_USAGE_VOICE_MESSAGE
    };

    audioRenderer = await audio.createAudioRenderer(rendererOptions);
    await audioRenderer.start();
    console.log('✅ 播放游戏音效，不会打断听书');
  } catch (err) {
    console.error('播放失败:', err.message);
  } finally {
    // 及时释放资源
    if (audioRenderer) {
      await audioRenderer.release();
    }
  }
}

2. 方案二：使用AudioSession声明"共享"意图（进阶：精细控制）

核心思路 ：通过AudioSession显式告知系统"我允许与其他音频共存"，系统会触发"音量衰减（Ducking）"而非"强制中断"。

修复代码：

复制代码

import audio from '@ohos.multimedia.audio';

async function playWithAudioSession() {
  let audioSession: audio.AudioSession | null = null;
  let audioRenderer: audio.AudioRenderer | null = null;
  
  try {
    // 1. 创建音频会话并设置为"共享/混音"模式
    audioSession = await audio.createAudioSession();
    await audioSession.setInterruptMode(audio.InterruptMode.SHARED); // 关键：共享焦点
    await audioSession.activate();

    // 2. 创建渲染器并绑定会话
    const rendererOptions: audio.AudioRendererOptions = {
      streamInfo: { ... },
      streamUsage: audio.StreamUsage.STREAM_USAGE_MEDIA,
      sessionToken: audioSession.getToken() // 绑定会话
    };

    audioRenderer = await audio.createAudioRenderer(rendererOptions);
    await audioRenderer.start();
    console.log('✅ 使用AudioSession共享模式，听书音量会自动降低');
    
  } catch (err) {
    console.error('AudioSession播放失败:', err.message);
  } finally {
    // 3. 及时释放资源（防止焦点泄漏）
    if (audioRenderer) {
      await audioRenderer.release();
    }
    if (audioSession) {
      await audioSession.deactivate();
      await audioSession.release();
    }
  }
}

3. 效果对比：从"误杀"到"共存"

修复前（默认MEDIA）	修复后（GAME/Session）	用户体验
听书被强制停止	✅ 听书继续播放（音量可能降低）	无感知/轻度干扰
用户需手动恢复	✅ 自动恢复（若为Pause策略）	无需操作

三、进阶：不同场景的"防打断"策略

1. 场景适配表：什么声音该用什么类型

你的应用场景	推荐StreamUsage	对听书的影响
计算器按键音、翻译提示音	`STREAM_USAGE_GAME`	✅ 完全不打断
广告视频、启动页背景音	`STREAM_USAGE_VOICE_MESSAGE`	⚠️ 听书暂停（结束后恢复）
语音通话、录音回放	`STREAM_USAGE_VOICE_COMMUNICATION`	❌ 强制打断（合理行为）

2. 避坑指南：音频焦点的"三必须"

规则	原因	违反后果
必须及时释放资源	AudioSession和Renderer占用焦点	听书无法恢复播放
必须绑定sessionToken	配置需通过Token传递给渲染器	AudioSession配置失效
必须测试后台场景	焦点策略在后台可能变化	线上用户投诉

四、总结：工具类应用的"音频友好"法则

MEDIA是"杀手" ：默认使用STREAM_USAGE_MEDIA会强制终止其他媒体流（如听书）。
GAME是"朋友" ：工具类音效优先使用STREAM_USAGE_GAME，完全不会打断听书。
Session是"绅士" ：视频类内容使用AudioSession+SHARED模式，降低音量而非切断。

通过这一招"流类型降级"或"会话共享"，你的工具应用将彻底告别"杀后台听书"的恶名，成为HarmonyOS生态中友好的音频参与者。