Android 音频焦点与共存播放机制研究#

它并不是物理排他的#

我们常听说的“音频焦点（Audio Focus）”，在 Android 系统里本质上并不是一个物理开关，而是一种**“礼貌协议”（Cooperative Protocol）**。

当你想播放声音时，你需要向系统（AudioManager）发出一个 requestAudioFocus 请求，声明你需要占用声道。系统会根据你请求的等级，给当前正在播放的其他 App 发送不同级别的 LOSS（丢失焦点）回调：

• AUDIOFOCUS_LOSS (-1)：永久丢失。比如接到了电话，或者用户打开了另一款大型的独占音乐 App。
• AUDIOFOCUS_LOSS_TRANSIENT (-2)：临时丢失。比如微信来了条提示音，或者用户在那边刷了一个短视频。
• AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK (-3)：临时丢失，但允许你“低头”（Duck）。比如导航播报时，你可以把自己的音量压低一半，不用完全闭嘴。

TIP

对应谷歌文档的链接：AudioManager

核心事实：收到这些信号后，系统通常不会直接物理做相关的操作（前提是你是合法的媒体应用），而是看你自己的代码怎么写。常规的、老实的 App 收到 -1 或 -2 时，代码里会乖乖调用 player.pause()。于是外界看起来就像是“被抢走焦点，声音断了”。

“不申请焦点”行不通吗？#

既然收到信号就要乖乖暂停，那最直觉的想法自然是：那我干脆一上来就不申请音频焦点，是不是系统就不管我了？

在早年间的 Android 系统中，这确实可行。但在最新的 Android 15+ 机制下，这其实是在“裸奔”。系统引入了 AudioHardening 策略。如果你作为一个后台媒体应用，试图在没有持有有效音频焦点（或相应权限等级不足）的情况下向硬件输出音频数据，系统会立刻探测到你的非法行为，并从硬件层强制执行 Mute（静音）。

抓到的底层日志非常直白：

1
AudioHardening background playback would be muted for com.example.pilinara (10164), level: full

所以得出一个非常明确的结论：想要播放，你必须去拿焦点，这是“准入证”。

1. 配置层：持证上岗#

首先是需要请求相关的权限

1. 修改 AndroidManifest.xml (必须) 从 Android 14 开始，系统要求必须显式声明前台服务类型。对于视频/音频播放，必须声明 mediaPlayback。

1
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
2

3
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
4

5
<application ...>
6
    <service
7
        android:name=".YourPlaybackService"
8
        android:foregroundServiceType="mediaPlayback"
9
        android:export="false">
10
    </service>
11
</application>

对于希望“与其他应用共存”的场景，我们在 Android 端坚决不再使用类似 androidAudioFocusGainType: null 这样企图隐身的危险写法（实际上这也是违背 Dart 强类型语法的），而是恢复它作为主权媒体应用的声明。

1
// 在 Android 上保持不变，老老实实申请最高级别焦点
2
await session.configure(const AudioSessionConfiguration.music());

这确保了我们的 App 在系统层面拥有“准入证”。

2. 逻辑层：精准拦截“劝退”信号#

真正的核心手术在 interruptionEventStream 监听器里。当产生冲突时：

• 系统发来 AudioInterruptionType.pause（对应原生的 LOSS_TRANSIENT）：比如打开了别的短视频软件。这时候如果用户开启了 mixWithOthers 选项，选择“厚脸皮”，直接 return 忽视他。
• 系统发来 AudioInterruptionType.unknown（对应原生的 LOSS 高危信号）：比如打进来了电话。这种涉及严重系统资源回收或高优先级通话时，必须强制暂停。

具体的代码实现实际上非常轻量：

1
session.interruptionEventStream.listen((event) {
2
  if (event.begin) {
3
    switch (event.type) {
4
      case AudioInterruptionType.duck:
5
        // 被压低音量，比如系统导航语音
6
        PlPlayerController.setVolumeIfExists(... * 0.5);
7
        break;
8

9
      case AudioInterruptionType.pause:
10
        // 如果系统发来临时切断（比如外部播放音乐），且我们开启了同时播放选项，直接拦截（装聋作哑）
11
        if (Pref.mixWithOthers) return;
12

13
        // 否则乖乖暂停
14
        PlPlayerController.pauseIfExists(isInterrupt: true);
15
        break;
16

17
      case AudioInterruptionType.unknown:
18
        // 来了电话这种硬断事件，无论如何都要老实暂停
19
        PlPlayerController.pauseIfExists(isInterrupt: true);
20
        break;
21
    }
22
  } else {
23
    // 恢复逻辑...
24
  }
25
});

。