三种交互模式  Pain Point 3：在车载或多窗口环境下不清楚何时可以并发播放导致 UI 与实际行为不一致。

Android 程序根据请求方与当前持有者上下文决定交互模式：

• 独占交互 ：一次只允许一个应用持有焦 点。 新请求被授予时现有持有者立即失去焦 点。 / li>
• 拒绝交互 ：传入请求直接被拒绝。例如通话期间音乐尝试获取 focus 会返回 REQUEST_FAILED。/ li>
• 并发交互 ：AAOS 特有，仅在满足特定条件时允许多个应用共存。/ li> / ul>

五、源码深度分析  Pain Point 4：阅读官方源码时难以定位关键入口，导致实现细节漏掉。

焦點請求完整調用鏈   

// 步骤一：构造 AudioFocusRequest
AudioAttributes attrs = new AudioAttributes.Builder
.setUsage
.setContentType
.build;AudioFocusRequest request = new AudioFocusRequest.Builder(
AudioManager.AUDIOFOCUS_GAIN)
.setAudioAttributes
.setOnAudioFocusChangeListener
.setWillPauseWhenDucked // 不因 duck 而 pause
.build;// 步骤二：向 AudioManager 发起请求
int result = audioManager.requestAudioFocus;// result == AUDIOFOCUS_REQUEST_GRANTED?开始播放 : 延迟或降級
/ code>

MediaFocusControl 仲裁主要

• 维护 mFocusStack —— 栈式结构记录所有 FocusRequester 实例。不过，/ li>
• grant/reject/duck 决策依据 FocusGain 类型还有当前 stack 状态。/ li>
• 通过 IAudioPolicyCallback 将 focusChange 回调分发给对应客户端。/ li>
• 利用 VolumeShaper 实现自动 ducking 与 unduck。说起来，/ li> / ul>

六、不同 Android 版本行为差异   Pain Point 5：旧机型未强制淡出导致兼容性问题。需要针对不同 API 做适配。

从 Android?开始，“建议性契约”升级为“强制性规则”。若新 app 在已有 focus 的情况下抢占。将触发自动 fade‑out，并在来电时将所有媒体静音。/ p>

七、闪避机制详解   Pain Point 6：未正确实现 duck 时背景音乐突兀降低或根本不降导致使用者体验差。怎么说呢，

触发条件   

• /AUDIOFOCUSGAINTRANSIENTMAYDUCK/ 新请求使用此常量；/ li>
• /setPauseWhenDucked/ 当前持有者未设置 pause；/ li>
• 当前持有者已注册 OnAudioFocusChangeListener 并接受 CAN_DUCK 回调；/ li> / ul>

实现细节   

• 框架使用 {@link VolumeShaper} 完成平滑降噪与恢复；/ li>
• 框架不会强制 duck，由业务自行控制；/ li /> 调用 {@link VolumeShaper#reverse} 确保回到原始音量；老实说，/ ul>

Pain Point 7：代码示例散落文档。不易复制粘贴到项目中，