引子

说 Audio Focus 前先说个很简单需求：来电时暂停正在播放的音乐，电话结束时恢复播放。

看到这个需求，第一反应肯定是：监听用户来电状态，作相应操作。这里不多做介绍，这样做有个不好的地方就是需要隐私权限！这样做一点也不优雅。

后来搜索时看到一篇分析文章：Android来电时停止音乐播放的流程（顺便说一嘴，这篇转载居然不注明出处！！）。文章里的分析很明确的指出，系统在框架层就很好的帮我们处理了这个需求，问题是如何将音乐交给系统框架来处理呢？

音频焦点

问题的解决方法就是：请求系统的音频焦点（Request the Audio Focus)。

如果英文还行，强烈建议请看官方的原文：Managing Audio Playback，里面介绍的很清楚。以下为简单概述。

官方文档指出Android 在处理音频播放是分了多个“音频流”的，如音乐流、音效流、电话声音流等，使控制音量时可以互不干涉。多数情况下我们播放音乐都是使用 STREAM_MUSIC 音频流。

另外，系统中可能会有多个应用程序会播放音频，所以需要考虑他们之间该如何协调，为了避免同时播放音乐，Android 系统使用音频焦点来进行统一管理，即只有获得了音频焦点的应用程序才可以播放音乐。

那么，播放音频应该这样来做：

  1. 获取音频焦点 requestAudioFocus
  2. 获取成功后，开始播放音频
  3. 处理音频焦点的丢失和“DUCK”
  4. 播放完毕后取消焦点

如此便可以完美的解决引子里的需求。

一个简单的示例

MusicService.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

public class MusicService extends Service {

   private AudioManager mAm;
   private boolean isPlaymusic;
   private String url;
   private MediaPlayer mediaPlayer;

   @Override
   public void onCreate() {
       super.onCreate();
       mAm = (AudioManager) getSystemService(AUDIO_SERVICE);
   }

   @Override
   public void onStart(Intent intent, int startId) {
       if (intent != null) {
           Bundle bundle = intent.getExtras();
           if (bundle != null) {
               isPlaymusic = bundle.getBoolean("isPlay", true);
               url = bundle.getString("url");
               if (isPlaymusic)
                   play();
               else
                   stop();
           }
       }

   }

   OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {
       public void onAudioFocusChange(int focusChange) {
           if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT) {
               // Pause playback
               pause();
           } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
               // Resume playback
               resume();
           } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {
               // mAm.unregisterMediaButtonEventReceiver(RemoteControlReceiver);
               mAm.abandonAudioFocus(afChangeListener);
               // Stop playback
               stop();
           }

       }
   };

   private boolean requestFocus() {
       // Request audio focus for playback
       int result = mAm.requestAudioFocus(afChangeListener,
       // Use the music stream.
               AudioManager.STREAM_MUSIC,
               // Request permanent focus.
               AudioManager.AUDIOFOCUS_GAIN);
       return result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED;
   }

   private void resume() {
       if (mediaPlayer != null) {
           mediaPlayer.start();
       }
   }

   private void pause() {
       if (mediaPlayer != null && mediaPlayer.isPlaying()) {
           mediaPlayer.pause();
       }
   }
   OnCompletionListener completionListener = new OnCompletionListener() {

       @Override
       public void onCompletion(MediaPlayer player) {
           if(!player.isLooping()){
               mAm.abandonAudioFocus(afChangeListener);
           }
       }
   };
   private void play() {
       if (requestFocus()) {
           if (mediaPlayer == null) {
               try {
                   mediaPlayer = new MediaPlayer();
                   mediaPlayer.setDataSource(url);
                   mediaPlayer.prepare();
                   mediaPlayer.setOnCompletionListener(completionListener);
               } catch (IOException e) {
                   e.printStackTrace();
               }
           }

           if (!mediaPlayer.isPlaying()) {
               mediaPlayer.start();
           }
       }
   }

   @Override
   public void onDestroy() {
       super.onDestroy();
       if (mediaPlayer != null)
           mediaPlayer.release();
   }

   private void stop() {
       if (mediaPlayer != null) {
           mediaPlayer.stop();
       }
   }
   @Override
   public IBinder onBind(Intent arg0) {
       // TODO Auto-generated method stub
       return null;
   }
}

经模拟器测试，当来电时音频焦点会给到铃声流，并打出日志：

I/AudioService(1235):  AudioFocus  requestAudioFocus() from AudioFocus_For_Phone_Ring_And_Calls

此时MusicService中的afChangeListener会得到AUDIOFOCUS_LOSS_TRANSIENT，于是会暂停播放音频。
当通话结束或者挂掉电话，afChangeListener会得到AUDIOFOCUS_GAIN，于是恢复播放音频。

注意:

  1. 播放完毕一定要禁止掉请求的音频焦点abandonAudioFocus(afChangeListener)，否则，如果播放完毕后的某个时段刚好有个通话结束，并且此时没有其他的应用占用了焦点，系统会重新通知服务里的afChangeListener，导致音频再次的播放。
  2. 如果丢失的短暂音频焦点允许DUCK状态AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK，在这种情况下，应用程序降低音量继续播放，不需要暂停。再次获取后，恢复原来的音量。

Author: Yrom

Link: https://yrom.net/blog/2013/11/08/audio-focus/

License: 知识共享署名-非商业性使用 4.0 国际许可协议