Android音频焦点处理方法

前两天在项目上做了对音频焦点使用方法的一个总结，记录在下面。

---

在Android设备上，默认可以有多个应用同时播放音频，但是，这种处理带来的用户体验并不好，为了解决这个问题，Android引入了音频焦点机制，一次只能有一个App持有音频焦点。

一般情况下，当一个App失去音频焦点时，为了有较好的用户体验，它应该主动暂停播放，从而使新获得音频焦点的App可以清晰的播放音频，避免混音的情况。

---

处理音频焦点一些规则

以下是官方建议的处理音频焦点应该遵循的一些规则：

1. 在开始播放之前，调用requestAudioFocus()方法，并检查返回值是否是AUDIOFOCUS_REQUEST_GRANTED，若成功获取，则开始播放。
2. 当App失去音频焦点时，根据失去的焦点类型，应该暂停播放，或者将音量调低。
3. 当播放结束时，释放音频焦点。

---

如何处理音频焦点

处理音频焦点都是通过AudioManager这个类，如下是获得该类实例的方法：
AudioManager am = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
下面介绍音频焦点处理相关的一些方法（不同的Android版本处理音频焦点的方式略有差别，以下内容基于Android 4.4）。

• requestAudioFocus()：用于申请音频焦点
• abandonAudioFocus()：用于释放音频焦点
• AudioManager.OnAudioFocusChangeListener接口，提供了onAudioFocusChange()方法来监听音频焦点变化

下面进行详细介绍。

1. requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint)
   参数：
   • AudioManager.OnAudioFocusChangeListener l
     用于监听音频焦点变化，从而可以进行适当的操作，例如暂停播放等。

   • streamType
     申请音频焦点处理的音频类型，例如，当播放音乐时，可以传入STREAM_MUSIC；当播放铃声时，可以传入STREAM_RING。表中列出了所有的可选值：

     
     streamType可选类型
   • durationHint
     可选值有以下五个：
     (1) AUDIOFOCUS_GAIN： 此参数表示希望申请一个永久的音频焦点，并且希望上一个持有音频焦点的App停止播放；例如在需要播放音乐时。
     (2) AUDIOFOCUS_GAIN_TRANSIENT：表示申请一个短暂的音频焦点，并且马上就会被释放，此时希望上一个持有音频焦点的App暂停播放。例如播放一个提醒声音。
     (3) AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK：效果同AUDIOFOCUS_GAIN_TRANSIENT，只是希望上一个持有焦点的App减小其播放声音(但仍可以播放)，此时会混音播放。例如导航播报。
     (4) AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE： 表示申请一个短暂的音频焦点，并且会希望系统不要播放任何突然的声音（例如通知，提醒等），例如用户在录音。
     返回值：
     AUDIOFOCUS_REQUEST_GRANTED或者AUDIOFOCUS_REQUEST_FAILED

2. abandonAudioFocus(OnAudioFocusChangeListener l)
参数同上。
返回值同上。

3. AudioManager.OnAudioFocusChangeListener
当音频焦点发生变化时，可以在OnAudioFocusChangeListener的onAudioFocusChange(int focusChange)方法中监听到，下面详细说明该方法。
onAudioFocusChange(int focusChange)
参数：focusChange可以表明当前音频焦点发生的是何种变化，需要根据该参数状态做出正确的响应。
分为获得和丢失两种情况：

• 获得：AUDIOFOCUS_GAIN
  表示获得音频焦点，此时应该开始播放
• 丢失音频焦点，这时分为以下两种情况：
  • 短暂的丢失：
    如果focusChange的值是AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK 或者 AUDIOFOCUS_LOSS_TRANSIENT时，你的App需要降低播放音量 或者暂停播放(但是需要记录当前的播放状态，以便后续恢复播放)。
    在短暂丢失焦点期间，你的App应该持续关注音频焦点的变化，当再次获得焦点时，恢复播放。
  • 永久的丢失
    若值为AUDIOFOCUS_LOSS，你的App应该立即停止播放，并且当再次获得音频焦点时，也不会恢复播放，只有当用户主动播放时，再开始播放。

---

示例

下面是一个申请长音频焦点，播放音乐的例子：

AudioManager am = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);  
AudioManager.OnAudioFocusChangeListener afChangeListener =  
    new AudioManager.OnAudioFocusChangeListener() {  
     public void onAudioFocusChange(int focusChange) {  
       if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {  
        // Permanent loss of audio focus  
         // Pause playback immediately  
         mediaController.getTransportControls().pause();  
         mediaController.getTransportControls().stop();  
       } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT) {  
         // Pause playback  
       } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {  
         // Lower the volume, keep playing  
       } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {  
         // Your app has been granted audio focus again  
         // Raise volume to normal, restart playback if necessary  
       }  
     }  
   };     
 ...
 ...   
 // Request audio focus for playback  
 int result = am.requestAudioFocus(afChangeListener,  
                              // Use the music stream.  
                             AudioManager.STREAM_MUSIC,  
                              // Request permanent focus.  
                              AudioManager.AUDIOFOCUS_GAIN);  
 if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {  
     // Start playback  

 } 

 // 当播放完成时，建议调用abandonAudioFocus()方法来释放音频焦点，
 // 通知系统当前App不再需要音频焦点，解除OnAudioFocusChangeListener的注册。  
 // Abandon audio focus when playback complete  
 am.abandonAudioFocus(afChangeListener);

---

以上