音频焦点 Android Audio Focus

Android 音频焦点详解

音频焦点（Audio Focus）是 Android 系统用于协调多个应用同时访问音频输出的机制。当多个应用需要播放音频时，音频焦点确保用户听到的内容不会混乱（如多个音乐应用同时播放）。以下从核心概念、使用场景和代码实现三个方面展开说明。

一、音频焦点的核心概念

音频焦点的类型
- 永久性焦点：长时间占用焦点（如音乐播放器）。
- 短暂性焦点：临时占用焦点（如导航提示音）。
- Ducking：短暂降低其他应用音量（如通知音）。
焦点请求模式
- AUDIOFOCUS_GAIN：请求长期焦点，其他应用需停止播放。
- AUDIOFOCUS_GAIN_TRANSIENT：短暂占用焦点，其他应用需暂停。
- AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK：短暂占用焦点，其他应用降低音量（Ducking）。
- AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE：短暂独占焦点（如语音录制）。
焦点丢失处理
当其他应用请求焦点时，当前应用需根据情况暂停播放、停止播放或降低音量。

二、代码实现与分析

1. 请求音频焦点

使用 AudioManager 请求焦点，并监听焦点变化。

// 初始化 AudioManager
AudioManager audioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);// 创建焦点变化监听器
AudioManager.OnAudioFocusChangeListener afChangeListener = new AudioManager.OnAudioFocusChangeListener() {@Overridepublic void onAudioFocusChange(int focusChange) {switch (focusChange) {case AudioManager.AUDIOFOCUS_GAIN:// 重新获得焦点，恢复播放mediaPlayer.start();mediaPlayer.setVolume(1.0f, 1.0f);break;case AudioManager.AUDIOFOCUS_LOSS:// 永久丢失焦点，停止播放并释放资源mediaPlayer.stop();audioManager.abandonAudioFocus(afChangeListener);break;case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:// 暂时丢失焦点，暂停播放mediaPlayer.pause();break;case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:// 短暂降低音量mediaPlayer.setVolume(0.2f, 0.2f);break;}}
};// 请求音频焦点（以 AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 为例）
int result = audioManager.requestAudioFocus(afChangeListener,AudioManager.STREAM_MUSIC,AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK);if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {// 焦点获取成功，开始播放mediaPlayer.start();
} else {// 焦点获取失败，处理逻辑
}

2. 释放音频焦点

在播放结束或应用暂停时释放焦点：

audioManager.abandonAudioFocus(afChangeListener);

3. Android 8.0+ 的 AudioFocusRequest（API 26+）

对于 Android 8.0 及以上设备，使用 AudioFocusRequest 更灵活：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {AudioFocusRequest focusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN).setAudioAttributes(new AudioAttributes.Builder().setUsage(AudioAttributes.USAGE_MEDIA).setContentType(AudioAttributes.CONTENT_TYPE_MUSIC).build()).setAcceptsDelayedFocusGain(true) // 允许延迟获取焦点.setOnAudioFocusChangeListener(afChangeListener).build();int result = audioManager.requestAudioFocus(focusRequest);
}

三、使用函数

生命周期管理
- 在 onPause() 或 onStop() 中释放焦点。
- 在 onResume() 中重新请求焦点（视场景而定）。
Ducking 实现
在 AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK 回调中降低音量，而非暂停播放。
处理延迟焦点
Android 8.0+ 支持延迟获取焦点，需在 AudioFocusRequest 中配置 setAcceptsDelayedFocusGain(true)。

四、实际使用

通话打断音乐

一、通话打断音乐的流程

电话应用的优先级
通话属于高优先级音频场景，系统会强制其他应用让出音频焦点。当来电时，电话应用会请求 AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE 类型的焦点（短暂独占），以确保通话音频的独占性。
音乐播放器的响应
音乐播放器在失去焦点时，会通过注册的 OnAudioFocusChangeListener 收到 AUDIOFOCUS_LOSS 或 AUDIOFOCUS_LOSS_TRANSIENT 回调，此时需暂停播放。
通话结束后的恢复
当通话结束时，电话应用释放焦点，音乐播放器可能重新获得焦点（需主动重新请求），恢复播放。

二、代码示例与分析

1. 音乐播放器的焦点处理

// 初始化 AudioManager 和焦点监听器
AudioManager audioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);
MediaPlayer mediaPlayer = new MediaPlayer();AudioManager.OnAudioFocusChangeListener afChangeListener = new AudioManager.OnAudioFocusChangeListener() {@Overridepublic void onAudioFocusChange(int focusChange) {switch (focusChange) {case AudioManager.AUDIOFOCUS_LOSS:// 永久丢失焦点（如通话开始）mediaPlayer.pause();audioManager.abandonAudioFocus(this); // 主动释放焦点break;case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:// 暂时丢失焦点（如短暂通话提示）mediaPlayer.pause();break;case AudioManager.AUDIOFOCUS_GAIN:// 重新获得焦点（如通话结束）if (!mediaPlayer.isPlaying()) {mediaPlayer.start();}break;}}};// 播放音乐前请求焦点
int result = audioManager.requestAudioFocus(afChangeListener,AudioManager.STREAM_MUSIC,AudioManager.AUDIOFOCUS_GAIN
);if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {mediaPlayer.start();
}

2. 电话应用的行为（系统级实现）

电话应用的音频焦点请求由系统自动处理，开发者无需手动实现。其核心逻辑类似：

// 系统电话应用的简化逻辑
audioManager.requestAudioFocus(phoneFocusListener,AudioManager.STREAM_VOICE_CALL,AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE
);

三、关键注意事项

无需手动处理通话打断
音乐播放器只需正确实现 OnAudioFocusChangeListener，系统会自动触发暂停逻辑。开发者无需监听通话状态。
恢复播放的策略
- 如果通话短暂（如未接来电），焦点可能自动恢复（AUDIOFOCUS_GAIN），音乐自动播放。
- 若通话时间较长（如持续通话），建议在 onResume() 中重新请求焦点。
与其他高优先级场景的兼容
除通话外，导航提示、警报声等也会通过音频焦点机制中断音乐，处理逻辑一致。

Android 8.0+ 的适配
在 Android 8.0 及以上版本，建议使用 AudioFocusRequest 对象（需检查版本）：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {AudioFocusRequest focusRequest = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN).setAudioAttributes(new AudioAttributes.Builder().setUsage(AudioAttributes.USAGE_MEDIA).build()).setOnAudioFocusChangeListener(afChangeListener).build();audioManager.requestAudioFocus(focusRequest);
}