Android 9 Audio系統筆記：聲音焦點AudioFocusRequest說明

前言

最近發現很多小伙伴對于申請聲音焦點構造AudioFocusRequest.Builde物件時傳入的AUDIOFOCUS型別引數很迷惑，各種引數也不知道是用來干什么的，于是乎覺得有必要寫一篇來說明一下，
聲音焦點是谷歌提供的一套機制，這個機制是用來使應用間的播放與暫停等有序進行，而不至于系統聲音狀態混亂（比如打電話的時候又播放了音樂，導航播放的時候音樂聲音沒有降低），是一個十分有效的機制，各個應用遵循該機制時，才使系統聲音正常有序播放，

申請聲音焦點示例

申請聲音焦點引數設定說明：

//1、創建聲音焦點 requestBuilder
AudioAttributes.Builder attributesBuilder = new AudioAttributes.Builder();
attributesBuilder.setUsage(AudioAttributes.USAGE_MEDIA) // 表明是那種音源型別：這里是語音識別型別
.setContentType(AudioAttributes.CONTENT_TYPE_MUSIC);//背景關系，一般用不上
//2、這個引數 AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)下面會進行詳細說明
AudioFocusRequest.Builder requestBuilder = new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN);//申請聲音焦點型別
requestBuilder.setAudioAttributes(attributesBuilder.build())
.setAcceptsDelayedFocusGain(false) //是否接受延遲獲取聲音焦點
//設定對聲音焦點監聽
.setOnAudioFocusChangeListener(new AudioManager.OnAudioFocusChangeListener() {
@Override
public void onAudioFocusChange(int focusChange) {
   //3、對聲音焦點狀態變化進行處理
   //focusChange這個回呼的值會在下面進行詳細說明
    Log.d(TAG, "voice focus change : " + focusChange);
}
});
audioFocusVoice = requestBuilder.build();
//4、向AudioManager發起聲音焦點申請，
int voiceFocus = mAudioManager.requestAudioFocus(audioFocusVoice);

2、Builder引數AUDIOFOCUS_GAIN 說明

這里直接對Builder引數進行說明，Builder的構造引數有四個：

AUDIOFOCUS_GAIN = 1;//想要長期占有焦點，失去焦點者stop播放和釋放（原有聲音焦點者失去聲音焦點）
AUDIOFOCUS_GAIN_TRANSIENT = 2;//想要短暫占有焦點，失去焦點者pause播放（原有聲音焦點者繼續持有音焦點），比如語音、比如電話
AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = 3;//想要短暫占有焦點，失去焦點者可以繼續播放但是音量需要調
低，比如導航
AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = 4;//想要短暫占有焦點，但希望失去焦點者不要有聲音播放，比如電話

可以參考官方檔案給出的說明，官方給出的說明無外乎跟上面備注的一樣，
那么Builder傳入的引數是什么意思呢？來，這個引數實際的意思是：
**我需要申請這個型別的聲音焦點，系統你告訴大家我申請什么型別的聲音焦點，
我需要申請這個型別的聲音焦點，系統你告訴大家我申請什么型別的聲音焦點，
我需要申請這個型別的聲音焦點，系統你告訴大家我申請什么型別的聲音焦點， **
重要的事情默念三遍！
有點拗口，下面來嘗試解釋一下，
因為聲音焦點是個聲音堆疊，系統會記錄每個應用發出聲音焦點申請，這個堆疊正常情況下是遵循先進后出的原則，
我們分別來說明一下：

1、當申請者是AUDIOFOCUS_GAIN 型別時

它告訴系統，我申請的是長期占用焦點型別AUDIOFOCUS_GAIN ，其他的應該失去聲音焦點，所以當它申請成功的時，會通知堆疊的下面一個聲音焦點失去聲音焦點，并回呼-1給到申請該申請者，并從聲音堆疊中將其移除出去，

2、當申請者是AUDIOFOCUS_GAIN_TRANSIENT 型別時

它告訴系統，我申請的是短期期占用焦點型別AUDIOFOCUS_GAIN_TRANSIENT ，聲音堆疊里其他的應該不會失去聲音焦點，但是當它申請成功的時，系統會通知堆疊的下面一個聲音焦點回呼-2給到申請該申請者，這個-2意味著當前有別的應用申請了短暫聲音焦點，此時收到-2后的應用應該暫停多媒體等的播放，當申請者釋放掉聲音焦點后，系統會將其移除出聲音堆疊，并將它底下的移到堆疊頂位置，并通知其獲取生音焦點（系統回呼1給到該應用），

3、當申請者是AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK 型別時

它告訴系統，我申請的是短期期占用焦點型別并且希望其他應用壓低聲音AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK ，聲音堆疊里其他的應該不會失去聲音焦點，但是當它申請成功的時，系統會通知堆疊的下面一個聲音焦點回呼-3給到申請該申請者，這個-3 意味著當前有別的應用申請了短暫聲音焦點并希望能降低音量，此時收到-3后的應用應該壓低播放的音量繼續播放，當申請者釋放掉聲音焦點后，系統會將其移除出聲音堆疊，并將它底下的移到堆疊頂位置，并通知其獲取生音焦點（系統回呼1給到該應用），

原始碼邏輯如下：

//frameworks/base/services/core/java/com/android/server/audio/FocusRequester.java
    /**
     * For a given audio focus gain request, return the audio focus loss type that will result
     * from it, taking into account any previous focus loss.
     * @param gainRequest
     * @return the audio focus loss type that matches the gain request
     */
    private int focusLossForGainRequest(int gainRequest) {//失去聲音焦點處理策略
        switch(gainRequest) {
            case AudioManager.AUDIOFOCUS_GAIN:
                switch(mFocusLossReceived) {
					/*
					mFocusLossReceived 這個變數以下這方法會改變它的值：
					1、int dispatchFocusChange(int focusChange)
					2、void handleFocusLoss(int focusLoss, @Nullable final FocusRequester frWinner, boolean forceDuck)
					3、void handleFocusGain(int focusGain) AudioManager.AUDIOFOCUS_NONE
					4、初始化時會設定為AudioManager.AUDIOFOCUS_NONE，不失去聲音焦點控制
					*/
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                    case AudioManager.AUDIOFOCUS_LOSS:
                    case AudioManager.AUDIOFOCUS_NONE:
                        return AudioManager.AUDIOFOCUS_LOSS;
                }
            case AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE:
            case AudioManager.AUDIOFOCUS_GAIN_TRANSIENT:
                switch(mFocusLossReceived) {
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                    case AudioManager.AUDIOFOCUS_NONE:
                        return AudioManager.AUDIOFOCUS_LOSS_TRANSIENT;
                    case AudioManager.AUDIOFOCUS_LOSS:
                        return AudioManager.AUDIOFOCUS_LOSS;
                }
            case AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK:
                switch(mFocusLossReceived) {
                    case AudioManager.AUDIOFOCUS_NONE:
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
                        return AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK;
                    case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                        return AudioManager.AUDIOFOCUS_LOSS_TRANSIENT;
                    case AudioManager.AUDIOFOCUS_LOSS:
                        return AudioManager.AUDIOFOCUS_LOSS;
                }
            default:
                Log.e(TAG, "focusLossForGainRequest() for invalid focus request "+ gainRequest);
                        return AudioManager.AUDIOFOCUS_NONE;
        }
    }

如下圖，以申請AUDIOFOCUS_GAIN為例說明系統聲音堆疊處理程序：

小結：
1、這個引數的作用就是告訴系統申請者想要申請了什么樣的型別，
2、同時會根據當前聲音堆疊狀態給系統決定是否申請成功等處理，
3、同時還告訴系統，希望系統通知其他應用做相應的聲音焦點變化處理，比如該暫停的暫停，該降音的降音等等

其他特殊情況

當聲音堆疊中的堆疊頂者申請的是lock時（Android系統中僅有系統APP可以設定，不過定制的ROM時可以自己修改開放權限），表示我當前想持有該聲音焦點，此時其他申請無法立即申請到聲音焦點，
這個時候setAcceptsDelayedFocusGain 就起作用了，這個函式什么意思呢？就是當處于聲音堆疊頂有強制占有聲音焦點無法立即獲取到聲音焦點的時候是否接受延遲獲取到聲音焦點，

如果setAcceptsDelayedFocusGain (true)

表示可以接受延遲獲取聲音焦點，此時系統會將其壓入聲音堆疊頂的底下，此時申請者未獲取到聲音焦點，也就是沒申請到聲音焦點，然而當強制占有聲音焦點者釋放聲音焦點后，系統會將強制占有聲音焦點彈出聲音堆疊，另外則會通知這個申請者獲取到聲音焦點，這個時候剛才申請的會變成聲音堆疊頂，那么這個時候表示就可以正常播放了，

如果setAcceptsDelayedFocusGain (false)

表示不接受接受延遲獲取聲音焦點，此時當聲音堆疊頂有強制占有聲音焦點的時候，系統直接回傳申請失敗其不將其壓入聲音堆疊內，申請處理流程結束，
當然，系統聲音焦點處理非常復雜（想深入了解系統對聲音堆疊處理請看Android MediaFocusControl等部分原始碼），這個僅僅是通常情況下的情況，但是基本滿足絕大部分使用場景了，當app開發能夠遵循谷歌的聲音焦點規范時，就會減少大量不必要的規避措施了，程式將會更健壯，

總結

如何申請：

1、當應用想長期占用聲音焦點時，并且當被其他聲音焦點占用釋放后再想獲取聲音焦點的時候使用：AUDIOFOCUS_GAIN
2、當應用想要短暫占有焦點，失去焦點者pause播放時候使用：AUDIOFOCUS_GAIN_TRANSIENT
3、當應用想要短暫占有焦點，失去焦點者可以繼續播放但是音量需要調低時候，使用：AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
4、當應用想要短暫占有焦點，但希望失去焦點者不要有聲音播放時候，使用：AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE

如何處理聲音狀態回呼：

public void onAudioFocusChange(int focusChange) {
    
}

當focusChange = -1時：表示，系統通知你失去聲音焦點，此時你應該停止播放
當focusChange = -2時：表示，系統通知你短暫失去聲音焦點，此時你應該暫停播放
當focusChange = -3時：表示，系統通知你需要壓低播放的聲音，此時你應該壓低音量繼續播放
當focusChange = 1時：表示，系統通知你獲取到聲音焦點了，你可以繼續播放了

好了到這里就結束了，有對Android系統的聲音相關疑問可以留言，我會盡力進行解答，希望能有所識訓，