AudioFocus的申请与释放

• 场景：当听音乐并且在刷朋友圈或者微博的时候，我们想点击一个视频看，此时音乐会暂停只保留视频播放，然后退出视频后音乐又重新播放；
  在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()：判断是否插入了耳机

---

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

---