Audio Focus机制以及AudioManager的使用

原文地址：http://tanxiaoya105.blog.163.com/blog/static/210328019201272295457523/

大纲：

一、介绍Audio Focus机制

二、AudioManager的一般使用

Android是多任务系统，Audio系统是竞争资源。( because there is only one audio output and there may be several media services
competing for its use)因为在只有一个音频输出，然而可能有很多的媒体程序去竞争使用它，这样就需要一种机制来管理。Android2.2之前，没有内建的机制来解决多个程序竞争Audio的问题，2.2引入了称作AudioFocus的机制来管理对Audio资源的竞争的管理与协调。

按照AudioFocus的机制，在使用Audio之前，需要申请AudioFocus，在获得AudioFocus之后才可以使用Audio；如果有别的程序竞争你正在使用的Audio，你的程序需要在收到通知之后做停止播放或者降低声音的处理。值得指出的是，这种机制是需要合作完成的，需要所有使用Audio资源的程序都按照这种机制来做，而如果有程序在它失去AudioFocus的时候仍然在使用Audio，AudioFocus拿它也没办法。而这一点对于开放系统的Android来说很致命的：用户可能安装没遵守这种机制的程序，或者版本太老还没引入这种机制的程序，这最终会导致很差的用户体验。

一、AudioFocus的申请与释放
下面看与AudioFocus的相关的类：
获取/放弃AudioFocus的方法都在android.media.AudioManager中，获取AudioFocus用requestAudioFocus()；用完之后，放弃AudioFocus，用bandonAudioFocus()。


requestAudioFocus
public int requestAudioFocus (AudioManager.OnAudioFocusChangeListener l,
int streamType, int durationHint)

Since: API Level 8

Request audio focus. Send a request to obtain the audio focus

Parameters：
l

	the listener to be notified of audio focus changes streamType
	the main audio stream type affected by the focus request durationHint
	use AUDIOFOCUS_GAIN_TRANSIENT to indicate this focus request is temporary, and focus will be abandonned shortly. Examples of transient requests are for the playback of driving directions, or notifications sounds. Use AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK to indicate also that it's ok for the previous focus owner to keep playing if it ducks its audio output. Use AUDIOFOCUS_GAIN for a focus request of unknown duration such as the playback of a song or a video.

Returns

AUDIOFOCUS_REQUEST_FAILED

or

AUDIOFOCUS_REQUEST_GRANTED

其中，参数：

streamType是《Android中的Audio播放：音量和远程播放控制》中说明的AudioStream，其值取决于AudioManager中的STREAM_xxx，在AudioStream的裁决机制中并未有什么实际意义；

durationHint是持续性的指示：

AUDIOFOCUS_GAIN

指示申请得到的Audio Focus不知道会持续多久，一般是长期占有；

AUDIOFOCUS_GAIN_TRANSIENT

指示要申请的AudioFocus是暂时性的，会很快用完释放的；

AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK不但说要申请的AudioFocus是暂时性的，还指示当前正在使用AudioFocus的可以继续播放，只是要“duck”一下（降低音量）。

AudioManager.OnAudioFocusChangeListener是申请成功之后监听AudioFocus使用情况的Listener，后续如果有别的程序要竞争AudioFocus，都是通过这个Listener的onAudioFocusChange()方法来通知这个Audio
Focus的使用者的。

返回值，可能是：

AUDIOFOCUS_REQUEST_GRANTED：申请成功；

AUDIOFOCUS_REQUEST_FAILED：申请失败。


public int abandonAudioFocus (AudioManager.OnAudioFocusChangeListener l)

二、AudioFocus被抢占与重新获得
由上节中知道，申请/释放AudioFocus时传入了AudioManager.OnAudioFocusChangeListener这个参数，其onAudioFocusChange()方法是Audio
Focus被抢占与再次获得通知的地方。所以，每个要使用AudioFocus的程序都要小心实现这个函数，保证AudioFocus实现的一致性。
onAudioFocusChange()方法的focusChange参数指示了该AudioFocus的竞争者对AudioFocus的拥有情况，取值如下：

AUDIOFOCUS_GAIN：获得了Audio Focus；

AUDIOFOCUS_LOSS：失去了Audio Focus，并将会持续很长的时间。这里因为可能会停掉很长时间，所以不仅仅要停止Audio的播放，最好直接释放掉Media资源。而因为停止播放Audio的时间会很长，如果程序因为这个原因而失去AudioFocus，最好不要让它再次自动获得AudioFocus而继续播放，不然突然冒出来的声音会让用户感觉莫名其妙，感受很不好。这里直接放弃AudioFocus，当然也不用再侦听远程播放控制【如下面代码的处理】。要再次播放，除非用户再在界面上点击开始播放，才重新初始化Media，进行播放。

AUDIOFOCUS_LOSS_TRANSIENT：暂时失去Audio Focus，并会很快再次获得。必须停止Audio的播放，但是因为可能会很快再次获得AudioFocus，这里可以不释放Media资源；

AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK：暂时失去AudioFocus，但是可以继续播放，不过要在降低音量。

下面是onAudioFocusChange()方法处理的代码片段：

OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {

public void onAudioFocusChange(int focusChange) {

if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT

// Pause playback

} else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {

am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);

am.abandonAudioFocus(afChangeListener);

// Stop playback

} else if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {

// Lower the volume

} else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {

// Resume playback or Raise it back to normal

}

}

};

OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {      public void onAudioFocusChange(int focusChange) {          if (focusChange == AudioManager.AUDIOFOCUS_LOSS_TRANSIENT              // Pause playback          } else if (focusChange == AudioManager.AUDIOFOCUS_LOSS) {              am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);              am.abandonAudioFocus(afChangeListener);              // Stop playback          } else if (focusChange == AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {              // Lower the volume          } else if (focusChange == AudioManager.AUDIOFOCUS_GAIN) {              // Resume playback or Raise it back to normal          }      }  };

三、典型的应用AudioFocus的场景
下面的时序图描述了AudioFocus被抢占与再次获取的典型场景：



Audio Focus被抢占与再次获取的时序图
注意：为了描述简单，此图中除了两个竞争Audio Focus的App之外，只用AudioManager表征了Android的AudioFocus机制中内部参与的对象，实际AudioManager只是外部的表象，内部参与的对象很多，回调函数也并非简单的直接由AudioManager调用，其中还包含了复杂的IPC机制。
图中：

AudioFocus Client通过requestAudioFocus()获取AudioFocus，在获得AudioFocus之后，开始播放Audio[Step#1 ~ #2]；

其它程序（Other App）也通过requestAudioFocus()获取AudioFocus [Step#3]

AudioFocus Client失去了Audio Focus，在onAudioFocusChanged()中，根据focusChange【focusChange的值与Other App申请时的durationHint相反，即focusChange = -1*durationHint】的值，做第二节中所描述的处理[Step#4]；

其它程序（Other App）获取Audio Focus之后，开始播放Audio[Step#5]；

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

AudioFocus Client重新获得了Audio Focus，可做进一步的处理 [Step#7]
小结
Audio Focus机制要参与各方充分理解并统一遵照施行，有没有遵照者或者实现有误的程序存在就可能打破这一机制，带来糟糕的用户体验。在保证Built-in程序没问题的前提下，如果进入AndroidMarket之前的程序都严格执行了AudioFocus相关的测试，应该也没问题。
使用Audio的程序要做到：
使用前，用requestAudioFocus()申请AudioFocus，并根据应用的实际选取恰当的durationHint值；

正确的在AudioManager.OnAudioFocusChangeListener中响应AudioFocus失去和重新获取事件；

Audio使用结束，用

abandonAudioFocus()

归还AudioFocus。

二、AudioManager的一般使用

AudioManager除了能在Audio Focus中使用外，最主要的是它能控制声音和铃声

AudioManager provides access to volume and ringer mode control.

AudioManager类位于android.Media 包中，该类提供访问控制音量和钤声模式的操作。

通过getSystemService(Context.AUDIO_SERVICE)方法获得AudioManager实例对象。

AudioManager audiomanage = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
audiomanager就是我们定义的控制系统声音的对象。

这里只讲述几个比较常用到的方法：

adjustVolume(int direction, int flags) ——用来控制手机音量大小，当传入的第一个参数为 AudioManager.ADJUST_LOWER 时，可将音量调小一个单位，传入AudioManager.ADJUST_RAISE 时，则可以将音量调大一个单位。

adjustStreamVolume(int streamType, int direction, int flags)——（以步长）调节手机音量大小

参数1：声音类型，可取为STREAM_VOICE_CALL（通话）、STREAM_SYSTEM（系统声音）、STREAM_RING（铃声）、STREAM_MUSIC（音乐）、STREAM_ALARM（闹铃声）

参数2：调整音量的方向，可取ADJUST_LOWER（降低）、ADJUST_RAISE（升高）、ADJUST_SAME

参数3：可选的标志位

setStreamVolume(int streamType, int index, int flags)——直接设置音量大小

getMode() ——返回当前音频模式，如 NORMAL（普通）, RINGTONE（铃声）, or IN_CALL（通话）

setMode()——设置声音模式，可取值NORMAL（普通）, RINGTONE（铃声）, or IN_CALL（通话）

getRingerMode() ——返回当前的铃声模式。如RINGER_MODE_NORMAL（普通）、RINGER_MODE_SILENT（静音）、RINGER_MODE_VIBRATE（震动）

setRingerMode(int ringerMode) ——改变铃声模式

getStreamVolume(int streamType) ——取得当前手机的音量，最大值为7，最小值为0，当为0时，手机自动将模式调整为“震动模式”。

getStreamMaxVolume（int streamType）——获得当前手机最大铃声。

setStreamMute(int streamType, boolean state

//音量控制,初始化定义

AudioManager mAudioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);

//最大音量

int maxVolume = mAudioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC);

//当前音量

int currentVolume = mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC);

直接控制音量的多少:

以一步步长控制音量的增减，并弹出系统默认音量控制条：

//降低音量，调出系统音量控制 if(flag ==0){ mAudioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC,AudioManager.ADJUST_LOWER, AudioManager.FX_FOCUS_NAVIGATION_UP); } //增加音量，调出系统音量控制 else if (flag ==1){ mAudioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC,AudioManager.ADJUST_RAISE, AudioManager.FX_FOCUS_NAVIGATION_UP); }

常用方法：

android audioManager获取音量：

先获取AudioManager实例，

AudioManager mAudioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);

//通话音量
int max = mAudioManager.getStreamMaxVolume( AudioManager.STREAM_VOICE_CALL );
int current = mAudioManager.getStreamVolume( AudioManager.STREAM_VOICE_CALL );
//系统音量
int max = mAudioManager.getStreamMaxVolume( AudioManager.STREAM_SYSTEM );
current = mAudioManager.getStreamVolume( AudioManager.STREAM_SYSTEM );
//铃声音量
max = mAudioManager.getStreamMaxVolume( AudioManager.STREAM_RING );
current = mAudioManager.getStreamVolume( AudioManager.STREAM_RING );
//音乐音量
max = mAudioManager.getStreamMaxVolume( AudioManager.STREAM_MUSIC );
current = mAudioManager.getStreamVolume( AudioManager.STREAM_MUSIC );

//提示声音音量
max = mAudioManager.getStreamMaxVolume( AudioManager.STREAM_ALARM );
current = mAudioManager.getStreamVolume( AudioManager.STREAM_ALARM );

一个即时音效的例子
上一小节介绍了SoundPool 类的常用方法，接下来将带领读者写一个即时音效的例子。具体步骤如下。
（1）打开Eclipse，导入本章源代码中名为Sample3_1的项目。

图3-1 raw 文件夹示意图

（2）在res 目录下有一个名为raw 的文件夹，其中包含本项目中所用到的声音文件，如图3-1 所示。
（3）下面将介绍layout 目录下的main.xml 文件的代码内容，在其中设置控件的布局。
代码位置：本书随书光盘中源代码\第3 章\Sample3_1\res\layout\main.xml。

1 <?xml version="1.0" encoding="utf-8"?>
2 <LinearLayout xmlns:android=" http://schemas.android.com/apk/res/android" 3 android:orientation="vertical"
4 android:layout_width="fill_parent"
5 android:layout_height="fill_parent"
6 >
7 <Button
8 android:text="播放音效1"
9 android:id="@+id/Button01"
10 android:layout_width="fill_parent"
11 android:layout_height="wrap_content">
12 </Button> <!--添加一个Button 控件-->
13 <Button
14 android:text="播放音效2"
15 android:id="@+id/Button02"
16 android:layout_width="fill_parent"
17 android:layout_height="wrap_content">
18 </Button> <!--添加一个Button 控件-->
19 <Button
20 android:text="暂停音效1"
21 android:id="@+id/Button1Pause"
22 android:layout_width="fill_parent"
23 android:layout_height="wrap_content">
24 </Button> <!--添加一个Button 控件-->
25 <Button
26 android:text="暂停音效2"
27 android:id="@+id/Button2Pause"
28 android:layout_width="fill_parent"
29 android:layout_height="wrap_content">
30 </Button> <!--添加一个Button 控件-->
31 </LinearLayout>

第2~6 行定义一个垂直方向上的线性布局。
第7~18 行为一个播放音效1 的按钮，以及一个播放音效2 的按钮。
第19~30 行为一个暂停播放音效1 的按钮，以及一个暂停播放音效2 的按钮。
（4）接着介绍在src 目录下的wyf.zcl 包中的MyActivity.java 类。
代码位置：本书随书光盘中源代码\第3 章\Sample3_1\src\wyf\zcl\MyActivity.java。

1 package wyf.zcl;
2 import java.util.HashMap; //引入相关包
3 ……//此处省略部分不重要代码，读者可在光盘源代码中查看
4 import android.widget.Button;
5 public class MyActivity extends Activity { //Activity 创建时调用
6 SoundPool sp; //得到一个声音池引用
7 HashMap<Integer,Integer> spMap; //得到一个map 的引用
8 Button b1; //声音播放控制按钮
9 Button b1Pause; //声音暂停控制按钮
10 Button b2; //声音播放控制按钮
11 Button b2Pause; //声音暂停控制按钮
12 @Override
13 public void onCreate(Bundle savedInstanceState){
14 super.onCreate(savedInstanceState);
15 setContentView(R.layout.main);
16 initSoundPool(); //初始化声音池
17 b1=(Button)findViewById(R.id.Button01); //声音播放控制按钮实例化
18 b2=(Button)findViewById(R.id.Button02); //声音播放控制按钮实例化
19 b1Pause=(Button)findViewById(R.id.Button1Pause);
20 b2Pause=(Button)findViewById(R.id.Button2Pause);
21 b1.setOnClickListener(new View.OnClickListener() {
22 @Override
23 public void onClick(View v) {
24 playSound(1,1); //播放第一首音效，循环一遍
25 Toast.makeText(MyActivity.this, "播放音效1",
Toast.LENGTH_SHORT). show();
26 }});
27 b1Pause.setOnClickListener(new View.OnClickListener() {
28 @Override
29 public void onClick(View v) {
30 sp.pause(spMap.get(1));
31 Toast.makeText(MyActivity.this, "暂停音效1",
Toast.LENGTH_SHORT). show();
32 }});
33 b2.setOnClickListener(new View.OnClickListener() {
34 @Override
35 public void onClick(View v) {
36 playSound(2,1); //播放第二首音效，循环一遍
37 Toast.makeText(MyActivity.this, "播放音效2",
Toast.LENGTH_SHORT). show();
38 }});
39 b2Pause.setOnClickListener(new View.OnClickListener() {
40 @Override
41 public void onClick(View v) {
42 sp.pause(spMap.get(2));
43 Toast.makeText(MyActivity.this, "暂停音效2",
Toast.LENGTH_SHORT). show();
44 }});
45 }
46 public void initSoundPool(){ //初始化声音池
47 sp=new SoundPool(
48 5, //该参数为设置同时能够播放多少音效
49 AudioManager.STREAM_MUSIC, //该参数设置音频类型
50 0 //该参数设置音频文件的质量，目前还没有效果，设置为0（默认值）
51 );
52 spMap=new HashMap<Integer,Integer>();
53 spMap.put(1, sp.load(this, R.raw.attack02, 1));
54 spMap.put(2, sp.load(this, R.raw.attack14, 1));
55 }
56 public void playSound(int sound,int number){
57 AudioManager am= //实例化AudioManager 对象
58 (AudioManager)this.getSystemService(this.AUDIO_SERVICE);
59 float audioMaxVolumn= //返回当前AudioManager 对象的最大音量值
60 am.getStreamMaxVolume(AudioManager.STREAM_MUSIC);
61 float audioCurrentVolumn= //返回当前AudioManager 对象的音量值
62 am.getStreamVolume(AudioManager.STREAM_MUSIC);
63 float volumnRatio=
64 audioCurrentVolumn/audioMaxVolumn;
65 sp.play(
66 spMap.get(sound), //播放的音乐ID
67 volumnRatio, //左声道音量
68 volumnRatio, //右声道音量
69 1, //优先级，0 为最低
70 number, //循环次数，0 无不循环，－1 无永远循环
71 1 //回放速度 ，该值在0.5～2.0 之间，1 为正常速度
72 );
73 }}

第2~11 行引入程序中所使用的相关包，以及声明相关引用。
第13 行为Activity 的onCreate()方法。当创建MyActivity 时调用该方法。
第21~44 行为播放音效1、播放音效2、暂停播放音效1、暂停播放音效2 的初始化及监听方法。
第46~55 行为初始化声音池，SoundPool 调用load()方法可加载音频文件，然后将加载了音频文件的SoundPool 添加到一个HashMap 中，提供给以后的调用。
第56~73 行为播放音效，调用SoundPool 中的play 方法，播放声音，参数sound是播放音效的ID，参数number 是播放音效的次数。该方法的使用上一小节已经做了详细介绍，此处不再赘述了。
（5）最终效果如图3-2 所示，单击播放音效1/播放音效2，将播放音效，单击暂停音效1/暂停音效2，将暂停正在播放的音效。

图3-2(a) 播放音效1 效果图

图3-2(b) 暂停音效2 效果图