Android音乐播放---AudioFocus的申请与释放

麻学博

2023-12-01

场景：当听音乐并且在刷朋友圈或者微博的时候，我们想点击一个视频看，此时音乐会暂停只保留视频播放，然后退出视频后音乐又重新播放；
在Android2.2时引入了AudioFocus机制来对Audio资源的竞争进行管理与协调；需要Audio资源双方都实现该机制才能完成当一方失去或者得到焦点时，另一方能够进行反应：停止播放或者降低音量的效果；
获取AudioManager实例：
AudioManager magager = (AudioManager)context.getSystemService(Context.AUDIO_SERVICE);
请求音频的焦点
requestAudioFocus(AudioManager.OnAudioFocusChangeListener l,int streamType,int durationHint)：
参数一：申请成功后对AudioFocus的监听；
参数二：音频类型
STREAM_ALARM：手机闹铃，STREAM_MUSIC：手机音乐
STREAM_RING：电话铃声，STREAM_SYSTEAM：手机系统
STREAM_DTMF：音调，STREAM_NOTIFICATION：系统提示
STREAM_VOICE_CALL：语音电话
参数三：
AudioManager.AUDIOFOCUS_GAIN：长时间获得AudioFocus
AudioManager.AUDIOFOCUS_LOSS:
长时间失去了Audio Focus，需要停止Audio的播放，并且释放Media资源。为了避免再次自动获得AudioFocus而继续播放，不然突然冒出来的声音会让用户感觉莫名其妙，直接放弃AudioFocus，如果需要再次播放，用户要在界面上点击开始播放，才重新初始化Media，进行播放。
AudioManager.AUDIOFOCUS_LOSS_TRANSIENT：
暂时失去AudioFocus，并会很快再次获得。必须停止Audio的播放，但是因为是暂时失去AudioFocus，可以不释放Media资源；
AUDIOFOCUS_GAIN_TRANSIENT：暂时获取焦点适用于短暂的音频
AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK：应用跟其他应用共用焦点但播放的时候其他音频会降低音量
返回值：
AUDIOFOCUS_REQUEST_GRANTED：申请成功；
AUDIOFOCUS_REQUEST_FAILED：申请失败；

放弃音频的焦点
abandonAudioFocus(AudioManager.OnAudioFocusChangeListenerl)

AudioFocus被抢占与再次获取的时序

Client通过requestAudioFocus()获取AudioFocus，在获得AudioFocus之后，开始播放Audio；

其它程序（Other App）也通过requestAudioFocus()获取同类AudioStream的AudioFocus

Client失去了AudioFocus，在onAudioFocusChanged()中，根据focusChange的值，做相应的处理（暂停or播放）；

其它程序（Other App）获取AudioFocus之后，开始播放Audio；

其它程序（Other App）使用Audio之后，通过abandonAudioFocus()归还AudioFocus；

Client重新获得了Audio Focus，可做进一步的处理

示例：
//获取AudioManager对象
AudioManager am = (AudioManager) getSystemService(Context.AUDIO_SERVICE);

//注册OnAudioFocusChangeListener监听
AudioManager.OnAudioFocusChangeListener afChangeListener = new AudioManager.OnAudioFocusChangeListener() {
public void onAudioFocusChange(int focusChange) {
if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT) {
if (mediaPlayer.isPlaying()) {
mediaPlayer.pause();
}

        } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
            if (mediaPlayer == null) {
                ...
            } else if (!mediaPlayer.isPlaying()) {

                mediaPlayer.start();

            }
            // Resume playback
        } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {
            if (mediaPlayer.isPlaying()) {

                mediaPlayer.stop();
            }
            am.abandonAudioFocus(afChangeListener);
        }
    }
};

//在播放的时候为AudioManager添加获取焦点的监听
int result = mManager.requestAudioFocus(afChangeListener,
AudioManager.STREAM_MUSIC,
AudioManager.AUDIOFOCUS_GAIN);
if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
mediaPlayer.start();
}
//在我们不用的时候将焦点释放掉
@Override
protected void onStop() {
// TODO Auto-generated method stub
super.onStop();
am.abandonAudioFocus(afChangeListener);
}

AudioManager的常用方法：

adjustStreamVolume(int streamType,int direction, int flags)：渐进式设置音量值，调用一次，提高或降低一单位音量值
参数一：指定音频类型，同上
参数二：
ADJUST_LOWER 降低音量
ADJUST_RAISE 升高音量
ADJUST_SAME 保持不变,这个主要用于向用户展示当前的音量
参数三：
FLAG_PLAY_SOUND 调整音量时播放声音
FLAG_SHOW_UI 调整时显示音量条

setStreamVolume(int streamType, int index, int flags)：直接设置音量值
参数一：指定音频类型，同上
参数二：音量值
参数三：同上

getMode( )：返回当前的音频模式

setMode( )：设置音频模式
MODE_NORMAL(普通)，MODE_RINGTONE(铃声),
MODE_IN_CALL(打电话)，MODE_IN_COMMUNICATION(通话)

getRingerMode( )：返回当前的铃声模式

setRingerMode(int streamType):设置铃声模式
RINGER_MODE_NORMAL（普通）、RINGER_MODE_SILENT（静音）
RINGER_MODE_VIBRATE（震动）

getStreamVolume(int streamType)：
获得手机的当前音量,最大值为7,最小值为0,当设置为0的时候,会自动调整为震动模式

getStreamMaxVolume(int streamType)：获得手机某个声音类型的最大音量值

setSpeakerphoneOn(boolean on)：设置是否打开扩音器

setMicrophoneMute(boolean on)：设置是否让麦克风静音

isMicrophoneMute()：判断麦克风是否静音或是否打开

isMusicActive()：判断是否有音乐处于活跃状态

isWiredHeadsetOn()：判断是否插入了耳机

当铃声模式为震动时需要添加权限：

Android音乐播放---AudioFocus的申请与释放

相关阅读

相关文章

相关问答

相关文档