注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。
原文链接: http://developer.android.com/training/managing-audio/audio-focus.html
有很多应用会要播放音频,所以他们之间如何交互是很重要的。为了防止每个音乐播放器应用在同一时间播放,Android使用音频焦点来调整音频的播放。也就是说,只有获得了音频焦点的应用可以播放音频。
在你的应用开始播放音频之前,它应该需求并接收音频焦点。另外,它应该知道如何监听音频焦点丢失的情况,并在发生焦点丢失时能够正确地响应。
一). 需求音频焦点
在你的应用开始播放音频之前,它应该获取要使用音频流的焦点。这需要调用
requestAudioFocus()
方法。如果请求成功,那么会返回
AUDIOFOCUS_REQUEST_GRANTED
。
你必须指定你正在使用的是什么流,和你期望获得暂时的还是永久的音频焦点。当你只需要短时间的播放音频时(比如当播放一些使用导航时),那么应该请求暂时焦点。当你计划在可预测的未来持续播放音频时(比如播放音乐),那么你应该请求永久焦点。
下面的代码请求音乐音频流的永久焦点。你必须在你开始播放之前就请求音频焦点,比如当用户按下了播放键,或下一级别游戏的背景音乐开始时:
AudioManager am = mContext.getSystemService(Context.AUDIO_SERVICE); ... // 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) { am.unregisterMediaButtonEventReceiver(RemoteControlReceiver); // Start playback. }
一旦你完成了播放,务必记得要调用 abandonAudioFocus() ,这将会告知系统你不再需要焦点并且注销相关联的 AudioManager.OnAudioFocusChangeListener 。对于放弃了暂时焦点的情况,这回允许任何被打断的应用继续播放。
// Abandon audio focus when playback complete am.abandonAudioFocus(afChangeListener);
当请求暂时音频焦点时,你可以有一个额外的选项:你是否希望启用“ ducking ”。一般的,当一个正常的应用丢失了音频焦点后,它会立马停止播放。通过请求允许“ ducking ”的暂时音频焦点,相当于你告知了其他应用:你们可以继续播放,但是他们需要在焦点回到他们手中之前降低音量。
// Request audio focus for playback int result = am.requestAudioFocus(afChangeListener, // Use the music stream. AudioManager.STREAM_MUSIC, // Request permanent focus. AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK); if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) { // Start playback. }
" Ducking "对于那些间歇性使用音频流的应用特别有用,比如那些语音驾驶提醒的。
在任何时候,若其他的应用像上面描述的那样请求音频焦点,它所选择的永久的活暂时的(有或没有“ ducking ”选项)音频焦点,在请求时都会被你注册的监听器所接收。
二). 处理焦点丢失
如果你的应用请求了音频焦点,它遵守这样的规定:如果其他应用请求焦点,它会按照次序丢失焦点。你的应用应该如何响应焦点丢失取决于丢失的方式。
在你请求音频焦点时,注册的音频焦点变更监听器中 onAudioFocusChange() 回调函数会接收一个参数,它描述焦点变化的事件。特别地,可能的焦点丢失事件反映的是上一部分的焦点请求类型,永久丢失,暂时丢失以及允许“ ducking ”的暂时焦点。
一般而言,一个暂时的音频焦点丢失会导致你的应用音频流没有声音,但其它方面会保持不变。你应该持续检查音频焦点的变化,并准备在你重新获得焦点时,从暂停额位置继续播放。
如果音频焦点要永久丢失,它假定另一个应用正在被用来听音频,并且你的应用应该将自己终止。在实际的场景下,这意味着停止播放,移除媒体按键监听,允许新的音频播放器单独处理这些事件,并放弃你的音频焦点。这样之后,在你恢复播放音频之前你只能期望用户的行为(如在你应用中按下播放键)。
在下面的代码中,我们停止播放器或者我们的媒体播放对象,如果音频焦点丢失是暂时的,另外恢复它当我们要恢复焦点时。如果焦点丢失是永久的,那么代码会注销我们的媒体按键时间接收器,并停止检查音频焦点变更。
OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() { public void onAudioFocusChange( int focusChange) { if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT // Pause playback } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) { // Resume playback } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) { am.unregisterMediaButtonEventReceiver(RemoteControlReceiver); am.abandonAudioFocus(afChangeListener); // Stop playback } } };
对于允许
ducking
而丢失焦点的情况,那么你可以使用“
ducking
”而不是停止播放。
三). Duck!
Ducking 是降低你音频外放的音量使得另一个应用的暂时性音频更容易听见,这样就不用暂停你自己应用的播放了。
下面的代码在暂时丢失焦点时降低我们播放器的音量,并在恢复焦点后,恢复音量。
OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() { public void onAudioFocusChange( int focusChange) { if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) { // Lower the volume } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) { // Raise it back to normal } } };
音频焦点的丢失是要响应广播中最重要的,但它不是唯一一个最重要的。系统会发送一系列的intent来让你改变用户的音频体验。下一节课将会讲授如何监听它们来提供用户的音频体验。