前言
最近發現很多小夥伴對於申請聲音焦點構造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系統的聲音相關疑問可以留言，我會盡力進行解答，希望能有所收穫。