Android音频焦点申请处理

为了便于理解,我们以android的8.0以前的版本为例,8.0以后有一定改动,但是基本思路一样。

关于管理音频焦点(8.0以前和更高版本)的官方文档:https://developer.android.google.cn/guide/topics/media-apps/audio-focus

Demo1地址:https://github.com/liuchenyang0515/MiniCase(该Demo包含了ListView、自定义Adapter、音频释放问题、音焦处理问题)

Demo2地址:https://github.com/liuchenyang0515/MiniCase_2(功能上和上一个相比没变,就是将activity重构成了fragment,加上viewpager)

处理音频焦点一些规则

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

  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。表中列出了所有的可选值:

      Android音频焦点申请处理

    • 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);
上一篇:android 调节媒体音量


下一篇:Kotlin(编程语言)让属性只能被赋值一次且不能为空