前两天在项目上做了对音频焦点使用方法的一个总结,记录在下面。
在Android设备上,默认可以有多个应用同时播放音频,但是,这种处理带来的用户体验并不好,为了解决这个问题,Android引入了音频焦点机制,一次只能有一个App持有音频焦点。
一般情况下,当一个App失去音频焦点时,为了有较好的用户体验,它应该主动暂停播放,从而使新获得音频焦点的App可以清晰的播放音频,避免混音的情况。
处理音频焦点一些规则
以下是官方建议的处理音频焦点应该遵循的一些规则:
- 在开始播放之前,调用requestAudioFocus()方法,并检查返回值是否是AUDIOFOCUS_REQUEST_GRANTED,若成功获取,则开始播放。
- 当App失去音频焦点时,根据失去的焦点类型,应该暂停播放,或者将音量调低。
- 当播放结束时,释放音频焦点。
如何处理音频焦点
处理音频焦点都是通过AudioManager这个类,如下是获得该类实例的方法:
AudioManager am = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
下面介绍音频焦点处理相关的一些方法(不同的Android版本处理音频焦点的方式略有差别,以下内容基于Android 4.4)。
- requestAudioFocus():用于申请音频焦点
- abandonAudioFocus():用于释放音频焦点
- AudioManager.OnAudioFocusChangeListener接口,提供了onAudioFocusChange()方法来监听音频焦点变化
下面进行详细介绍。
-
requestAudioFocus(OnAudioFocusChangeListener l, int streamType, int durationHint)
参数:- AudioManager.OnAudioFocusChangeListener l
用于监听音频焦点变化,从而可以进行适当的操作,例如暂停播放等。 -
streamType
申请音频焦点处理的音频类型,例如,当播放音乐时,可以传入STREAM_MUSIC;当播放铃声时,可以传入STREAM_RING。表中列出了所有的可选值:
- durationHint
可选值有以下五个:
(1) AUDIOFOCUS_GAIN: 此参数表示希望申请一个永久的音频焦点,并且希望上一个持有音频焦点的App停止播放;例如在需要播放音乐时。
(2) AUDIOFOCUS_GAIN_TRANSIENT:表示申请一个短暂的音频焦点,并且马上就会被释放,此时希望上一个持有音频焦点的App暂停播放。例如播放一个提醒声音。
(3) AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK:效果同AUDIOFOCUS_GAIN_TRANSIENT,只是希望上一个持有焦点的App减小其播放声音(但仍可以播放),此时会混音播放。例如导航播报。
(4) AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE: 表示申请一个短暂的音频焦点,并且会希望系统不要播放任何突然的声音(例如通知,提醒等),例如用户在录音。
返回值:
AUDIOFOCUS_REQUEST_GRANTED或者AUDIOFOCUS_REQUEST_FAILED
- AudioManager.OnAudioFocusChangeListener l
2. abandonAudioFocus(OnAudioFocusChangeListener l)
参数同上。
返回值同上。
3. AudioManager.OnAudioFocusChangeListener
当音频焦点发生变化时,可以在OnAudioFocusChangeListener的onAudioFocusChange(int focusChange)方法中监听到,下面详细说明该方法。
onAudioFocusChange(int focusChange)
参数:focusChange可以表明当前音频焦点发生的是何种变化,需要根据该参数状态做出正确的响应。
分为获得和丢失两种情况:
- 获得:AUDIOFOCUS_GAIN
表示获得音频焦点,此时应该开始播放 - 丢失音频焦点,这时分为以下两种情况:
- 短暂的丢失:
如果focusChange的值是AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK 或者 AUDIOFOCUS_LOSS_TRANSIENT时,你的App需要降低播放音量 或者暂停播放(但是需要记录当前的播放状态,以便后续恢复播放)。
在短暂丢失焦点期间,你的App应该持续关注音频焦点的变化,当再次获得焦点时,恢复播放。 - 永久的丢失
若值为AUDIOFOCUS_LOSS,你的App应该立即停止播放,并且当再次获得音频焦点时,也不会恢复播放,只有当用户主动播放时,再开始播放。
- 短暂的丢失:
示例
下面是一个申请长音频焦点,播放音乐的例子:
AudioManager am = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
AudioManager.OnAudioFocusChangeListener afChangeListener =
new AudioManager.OnAudioFocusChangeListener() {
public void onAudioFocusChange(int focusChange) {
if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {
// Permanent loss of audio focus
// Pause playback immediately
mediaController.getTransportControls().pause();
mediaController.getTransportControls().stop();
} else if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT) {
// Pause playback
} else if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {
// Lower the volume, keep playing
} else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
// Your app has been granted audio focus again
// Raise volume to normal, restart playback if necessary
}
}
};
...
...
// 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) {
// Start playback
}
// 当播放完成时,建议调用abandonAudioFocus()方法来释放音频焦点,
// 通知系统当前App不再需要音频焦点,解除OnAudioFocusChangeListener的注册。
// Abandon audio focus when playback complete
am.abandonAudioFocus(afChangeListener);
以上