【Android Developers Training】 45. 控制音频焦点

注：本文翻译自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来让你改变用户的音频体验。下一节课将会讲授如何监听它们来提供用户的音频体验。