MediaSession 使用中如何处理音频焦点冲突？

Question

在使用 MediaSession 进行音频播放时，常见的技术问题是如何在多个音频应用同时运行时处理音频焦点冲突？Android 系统通过 AudioManager 请求音频焦点来协调不同应用对音频输出的使用。当另一个应用请求音频焦点时，当前播放的应用可能会收到焦点丢失的回调，导致音频被中断。如何在 MediaSession 中监听并响应音频焦点变化，合理暂停或降低音量（Ducking），并在焦点恢复后继续播放，是实现良好音频体验的关键。开发者常困惑于如何正确设置 MediaSession 的回调、监听 AudioManager 的焦点事件，并与播放器状态进行同步，以确保应用在多音频场景下表现良好。

Answer 1

一、音频焦点机制概述

在 Android 系统中，多个音频应用同时运行时，系统通过 AudioManager 来协调不同应用对音频输出的使用。这种机制被称为音频焦点（Audio Focus）管理。音频焦点决定了哪个应用可以播放音频，以及在焦点变化时如何处理当前播放行为。

当一个应用请求音频焦点并成功获取后，其他应用可能会收到焦点丢失的通知。这时，应用需要根据不同的焦点变化类型（如临时丢失、永久丢失）做出响应，例如暂停播放或降低音量（Ducking）。

二、MediaSession 与音频焦点的结合

MediaSession 是 Android 提供的一个用于管理媒体播放的核心类，它不仅支持播放控制，还可以与音频焦点机制集成，实现对焦点变化的监听和响应。

开发者通常会使用 MediaSession.setCallback() 方法来设置回调，以处理播放控制和焦点变化事件。例如：

MediaSession mediaSession = new MediaSession(context, "MyAudioTag");
mediaSession.setCallback(new MediaSession.Callback() {
    @Override
    public void onAudioFocusChange(int focusChange) {
        switch (focusChange) {
            case AudioManager.AUDIOFOCUS_GAIN:
                // 恢复播放
                break;
            case AudioManager.AUDIOFOCUS_LOSS:
                // 长时间失去焦点，释放资源
                break;
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                // 暂停播放
                break;
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
                // 降低音量
                break;
        }
    }
});
  

三、音频焦点变化的类型与处理逻辑

Android 系统定义了四种主要的音频焦点变化类型，开发者需要根据不同的类型做出相应的处理：

• AUDIOFOCUS_GAIN：重新获得焦点，应恢复播放或取消静音。
• AUDIOFOCUS_LOSS：永久失去焦点，应停止播放并释放资源。
• AUDIOFOCUS_LOSS_TRANSIENT：临时失去焦点，应暂停播放。
• AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK：临时失去焦点但允许“Ducking”（降低音量），而不是完全暂停。

焦点变化类型	推荐处理方式
AUDIOFOCUS_GAIN	恢复播放或取消静音
AUDIOFOCUS_LOSS	停止播放，释放资源
AUDIOFOCUS_LOSS_TRANSIENT	暂停播放
AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK	降低音量

四、监听 AudioManager 的焦点事件

除了通过 MediaSession.Callback 接收焦点变化通知外，开发者也可以通过注册 AudioManager.OnAudioFocusChangeListener 监听器来手动处理焦点事件。

示例代码如下：

AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
AudioManager.OnAudioFocusChangeListener focusChangeListener = new AudioManager.OnAudioFocusChangeListener() {
    @Override
    public void onAudioFocusChange(int focusChange) {
        // 处理焦点变化逻辑
    }
};

int result = audioManager.requestAudioFocus(focusChangeListener,
        AudioManager.STREAM_MUSIC, AudioManager.AUDIOFOCUS_GAIN);

if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
    // 获得焦点，开始播放
}
  

五、与播放器状态的同步机制

为了确保播放器状态与音频焦点变化保持一致，开发者需要在焦点变化时更新播放器的内部状态。例如：

• 在焦点丢失时暂停播放器并记录当前播放位置。
• 在焦点恢复时根据记录的位置恢复播放。
• 在 Ducking 时降低音量，并在焦点恢复时恢复音量。

可以通过以下方式实现播放器状态同步：

private boolean isPausedDueToFocusLoss = false;

@Override
public void onAudioFocusChange(int focusChange) {
    switch (focusChange) {
        case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
            if (mediaPlayer.isPlaying()) {
                mediaPlayer.pause();
                isPausedDueToFocusLoss = true;
            }
            break;
        case AudioManager.AUDIOFOCUS_GAIN:
            if (isPausedDueToFocusLoss) {
                mediaPlayer.start();
                isPausedDueToFocusLoss = false;
            }
            break;
    }
}
  

六、流程图：音频焦点处理逻辑

以下是一个音频焦点变化处理的流程图，展示了从焦点请求到播放恢复的全过程：

graph TD
      A[开始播放] --> B{请求音频焦点}
      B -->|成功| C[开始播放]
      B -->|失败| D[等待焦点]
      C --> E[监听焦点变化]
      E --> F[焦点丢失]
      F --> G{焦点类型}
      G -->|AUDIOFOCUS_LOSS_TRANSIENT| H[暂停播放]
      G -->|AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK| I[降低音量]
      G -->|AUDIOFOCUS_LOSS| J[停止播放]
      E --> K[焦点恢复]
      K --> L{是否支持恢复}
      L -->|是| M[恢复播放]
      L -->|否| N[忽略]