Audio AudioFocus流程

     AudioFocus是Android引入的一个Audio协调机制,当多方需要使用Audio资源时,可以通过AudioFocus机制来协调配合,提高用户的体验。    该机制需要开发者主动去遵守,比如A应用没遵守该机制,则其它遵守了该机制的应用是完全没办法影响A应用的。    试想下后台在播放着音乐的时候你点开了某个视频,使得后台的音乐和视频的声音一起播放,毫无关联的声音一同播放会给用户带来极差的体验,此时我们就可以通过AudioFocus机制来解决这样的问题。

       使用AudioFocus机制主要是通过android.media.AudioManager这个类来进行的 public int requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint) 方法请求获取焦点,

如果获取成功,会返回int值AudioManager.AUDIOFOCUS_REQUEST_GRANTED,

失败则返回AudioManager.AUDIOFOCUS_REQUEST_FAILED。

通过abandonAudioFocus(OnAudioFocusChangeListener l)方法放弃焦点。 由于音频焦点是唯一的,所以可以在需要播放音乐时去申请音频焦点,如果获取到了则播放,同时正在播放的音频在失去音频焦点时停止播放或者调低音量,从而达到音频播放间的相互协调。

       对requestAudioFocus方法的参数进行解析:  OnAudioFocusChangeListener是一个接口,在这个接口里面只有一个方法需要实现 public void onAudioFocusChange(int focusChange);

该方法会在焦点状态变化的时候被调用 参数focusChange代表变化后当前的状态,一共有以下四个值:

AUDIOFOCUS_GAIN 重新获取到音频焦点时触发的状态。

AUDIOFOCUS_LOSS 失去音频焦点时触发的状态,且该状态应该会长期保持,此时应当暂停音频并释放音频相关的资源。

AUDIOFOCUS_LOSS_TRANSIENT 失去音频焦点时触发的状态,但是该状态不会长时间保持,此时应该暂停音频,且当重新获取音频焦点的时候继续播放。

AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK 失去音频焦点时触发的状态,在该状态的时候不需要暂停音频,但是应该降低音频的声音。

streamType(STREAM_RING,STREAM_MUSIC,STREAM_ALARM,STREAM_NOTIFICATION,STREAM_BLUETOOTH_SCO,STREAM_DTMF,STREAM_TTS)

durationHint用来表示获取焦点的时长,同时通知其它获取了音频焦点的OnAudioFocusChangeListener该如何相互配合,有以下几个值: AUDIOFOCUS_GAIN 代表此次申请的音频焦点需要长时间持有,原本获取了音频焦点的OnAudioFocusChangeListener 接口将会回调onAudioFocusChange(int focusChange) 方法,传入的参数为AUDIOFOCUS_LOSS。

AUDIOFOCUS_GAIN_TRANSIENT 代表此次申请的音频焦点只需短暂持有,原本获取了音频焦点的OnAudioFocusChangeListener 接口将会回调onAudioFocusChange(int focusChange) 方法,传入的参数为AUDIOFOCUS_LOSS_TRANSIENT。按照官方注释:适用于短暂的音频,在接收到事件通知等情景时可使用该durationHint。

AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE 代表此次申请的音频焦点只需短暂持有,原本获取了音频焦点的OnAudioFocusChangeListener 接口将会回调onAudioFocusChange(int focusChange) 方法,传入的参数为AUDIOFOCUS_LOSS_TRANSIENT。按照官方注释:在需要录音或语音识别等情景时可使用该durationHint。

AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 代表此次申请不需要暂停其它申请的音频播放,应用跟其他应用共用焦点但播放的时候其他音频会降低音量。原本获取了音频焦点的OnAudioFocusChangeListener 接口将会回调onAudioFocusChange(int focusChange) 方法,传入的参数为AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK。

Audio AudioFocus流程_第1张图片

 

在AudioManager的requestAudioFocus调用内部重载后的方法,根据传进来的streamType,构造了一个AudioAttributes对象向下传递,这个AudioAttributes主要是存储了一些音频流信息的属性. 这里面对falgs进行了与操作,由于之前传进来的是0,所以转换后的结果还是0.

继续AudioManager.requestAudioFocus中 public int requestAudioFocus(@NonNull AudioFocusRequest afr, @Nullable AudioPolicy ap) 里面首先在registerAudioFocusRequest中注册所有的

AudioFocusRequest private final ConcurrentHashMap mAudioFocusIdListenerMap =         new ConcurrentHashMap();        

 final FocusRequestInfo fri = new FocusRequestInfo(afr, (h == null) ? null :new ServiceEventHandlerDelegate(h).getHandler());

其中mAudioFocusIdListenerMap根据AudioFocusRequest中OnAudioFocusChangeListener对象的来生成一个key,value则为根据afr生成的FocusRequestInfo ,存储在了mAudioFocusIdListenerMap对象中。 而之前所述的abandonAudioFocus中有unregisterAudioFocusRequest做的操作就是remove掉mAudioFocusIdListenerMap中的OnAudioFocusChangeListener 

在AudioManager中还有一个电话相关的调用:

public void requestAudioFocusForCall(int streamType, int durationHint)

 这个调用的也是AudioService中的requestAudioFocus并且往其中设置了一个clientId为AudioSystem.IN_VOICE_COMM_FOCUS_ID的状态。 继续往下就是进入到AudioService.requestAudioFocus中首先会进行权限检查,这里面就用到了AudioSystem.IN_VOICE_COMM_FOCUS_ID 也就是说如果clientId等于AudioSystem.IN_VOICE_COMM_FOCUS_ID,且要申请到MODIFY_PHONE_STATE的权限,否则会申请焦点失败。

AudioService也只是做了中转,并没有做实际的操作,具体实现都是在MediaFocusControl.requestAudioFocus中大致过程如下:

private final Stack mFocusStack = new Stack(); 最主要的是对mFocusStack栈的操作,用来维护各client的申请和释放。

1.判断mFocusStack.size() 不能超过100

2.检查当前栈顶的元素是否是Phone应用占用,如果Phone处于占用状态,那么focusGrantDelayed = true。

3. 压栈之前,需要检查当前栈中是否已经有这个应用的记录,如果有的话就删除掉。  

如果mFocusStack不为空,并且栈顶的clientId与要申请焦点的clientId相同,得到栈顶元素即FocusRequester对象。如果申请的时长和flags都相同,则表示重复申请,直接返回成功,如果如果申请的时长和flags有一个不相同,则认为需要重新申请,此时如果focusGrantDelayed = false则需要将栈顶的元素出栈并将其释放

4. // focus requester might already be somewhere below in the stack, remove it          

  removeFocusStackEntry(clientId, false /* signal */, false /*notifyFocusFollowers*/);    

移除可能在栈中(栈顶或者栈中)其他位置存在着相同clientId的元素

a:如果要释放的应用是在栈顶,则释放之后,还需要通知先在栈顶应用,其获得了audiofocus;

b:如果要释放的应用不是在栈顶,则只是移除这个记录,不需要更改当前audiofocus的占有情况。

5.创建FocusRequester实例将请求包含的各种信息传入

AudioAttributes aa, int focusChangeHint, IBinder cb,  IAudioFocusDispatcher fd, String clientId, String callingPackageName, int flags, int sdk

6.如果focusGrantDelayed = true,那么就会延迟申请,并把此次请求FocusRequester实例入栈,但是此时记录不是被压在栈顶,而是放在lastLockedFocusOwnerIndex这个位置,也就是打电话这个记录的后面;如果focusGrantDelayed = false即不需要延迟获得焦点,同样创建FocusRequester实例,但是先要通知栈里其他记录失去焦点,然后压入栈顶,最后通知自己获得焦点成功

遍历mFocusStack,调用FocusRequester对象的handleExternalFocusGain方法 通知栈中其他元素丢失焦点流程. stackIterator.next()得到的是FocusRequester对象,因此查看FocusRequester中handleExternalFocusGain的代码

主要关注两个变量gainRequest和mFocusLossReceived, mFocusLossReceived这个值在handleFocusLoss中进行赋值的,默认值是AudioManager.AUDIOFOCUS_NONE。

 * gainRequest这个是传进来的,例如

AudioManager.AUDIOFOCUS_GAIN

 * return AudioManager.AUDIOFOCUS_LOSS

 * 若传进来的参数是 AudioManager.AUDIOFOCUS_GAIN_TRANSIENT

 * 则return AudioManager.AUDIOFOCUS_LOSS_TRANSIENT

在handleFocusLoss中

fd.dispatchAudioFocusChange(mFocusLossReceived, mClientId);

通过mFocusDispatcher对象调用了dispatchAudioFocusChange方法,将mFocusLossReceived和mClientId传了进去。

3.1 FocusRequester构造方法的第四个参数IAudioFocusDispatcher afl

3.2 MediaFocusControl的requestAudioFocus方法的第四个参数IAudioFocusDispatcher fd。

3.3 AudioService的requestAudioFocus方法的第四个参数IAudioFocusDispatcher fd 最终在AudioManager中实现。IAudioFocusDispatcher 的回调dispatchAudioFocusChange方法。

在dispatchAudioFocusChange中通过Handler发送MSSG_FOCUS_CHANGE

在ServiceEventHandlerDelegate 的创建handleMessage在其中根据MSSG_FOCUS_CHANGE来回调,而msg.arg1为focusChange即mFocusLossReceived

listener.onAudioFocusChange(msg.arg1);

最终app中实现onAudioFocusChange根据焦点的切换做相应的控制。

你可能感兴趣的:(Audio AudioFocus流程)