(1)使用硬件控制应用的声音,在Activity的生命周期内进行设置,只需一次并尽早调用,可以在Activity的OnCreate()方法中设置。
setVolumeControlStream(AudioManager.STREAM_MUSIC);
(2)使用播放按钮控制应用的声音,无论什么时候点击这些按钮,都会广播一个action为ACTION_MEDIA_BUTTON的Intent。
定义一个广播接收者就可以接收到广播,并执行相应的操作。
<receiverandroid:name=".RemoteControlReceiver">
<intent-filter>
<action Android:name="android.intent.action.MEDIA_BUTTON"/>
</intent-filter>
</receiver>
public classRemoteControlReceiver extends BroadcastReceiver {
@Override
public void onReceive(Contextcontext, Intent intent) {
if(Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
KeyEvent event =(KeyEvent)intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if (KeyEvent.KEYCODE_MEDIA_PLAY == event.getKeyCode()){
// Handle key press.
}
}
}
}
AudioManager am =mContext.getSystemService(Context.AUDIO_SERVICE);
...
// Start listening forbutton presses
am.registerMediaButtonEventReceiver(RemoteControlReceiver);
...
// Stop listening forbutton presses
am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);
注意:media button event receiver 并不像以往在Activity中注册和Activity不可见或销毁时反注册的情形,应该视应用在什么时候获取audio资源和释放audio资源时进行注册和反注册。
(3)管理Audio资源的焦点
使用requestAudioFocus获取声音资源焦点
获取成功返回AUDIOFOCUS_REQUEST_GRANTED
AudioManager am =mContext.getSystemService(Context.AUDIO_SERVICE);
...
// Request audio focusfor 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) {
am.registerMediaButtonEventReceiver(RemoteControlReceiver);
// Start playback.
}
注意:当完成playback操作之后记得要
//Abandon audio focus when playback complete
am.abandonAudioFocus(afChangeListener);
告诉系统你不再需要焦点和取消与AudioManager.OnAudioFocusChangeListener关联。好让其它应用继续完成playback操作。
获取Audio焦点,其它的应用声音降低直到焦点返回?
// Request audio focusfor playback
int result =am.requestAudioFocus(afChangeListener,
// Use the music stream.
AudioManager.STREAM_MUSIC,
// Request permanent focus.
AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK);
if (result ==AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
// Start playback.
}
AUDIOFOCUS_GAIN
指示申请得到的AudioFocus不知道会持续多久,一般是长期占有;
AUDIOFOCUS_GAIN_TRANSIENT
指示要申请的AudioFocus是暂时性的,会很快用完释放的;
AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
不但说要申请的AudioFocus是暂时性的,还指示当前正在使用AudioFocus的可以继续播放,只是要“duck”一下(降低音量)。
返回值,可能是:
AUDIOFOCUS_REQUEST_GRANTED:申请成功;
AUDIOFOCUS_REQUEST_FAILED:申请失败。
(4)处理焦点丢失,添加监听器
AudioManager.OnAudioFocusChangeListener是申请成功之后监听AudioFocus使用情况的Listener,后续如果有别的程序要竞争AudioFocus,都是通过这个Listener的onAudioFocusChange()方法来通知这个AudioFocus的使用者的。
OnAudioFocusChangeListener afChangeListener = new OnAudioFocusChangeListener() {
public void onAudioFocusChange(intfocusChange) {
if(focusChange == AUDIOFOCUS_LOSS_TRANSIENT )
// Pause playback
} elseif (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
// Resume playback
} elseif (focusChange == AudioManager.AUDIOFOCUS_LOSS) {
am.unregisterMediaButtonEventReceiver(RemoteControlReceiver);
am.abandonAudioFocus(afChangeListener);
// Stop playback
}
}
};
Duck模式:降低其它应用的声音
OnAudioFocusChangeListenerafChangeListener = new OnAudioFocusChangeListener() {
public void onAudioFocusChange(intfocusChange) {
if(focusChange == AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK) {
// Lower the volume
} elseif (focusChange == AudioManager.AUDIOFOCUS_GAIN) {
// Raise it back to normal
}
}
};
AUDIOFOCUS_GAIN:获得了Audio Focus;
AUDIOFOCUS_LOSS: 失去了AudioFocus,并将会持续很长的时间。这里因为可能会停掉很长时间,所以不仅仅要停止Audio的播放,最好直接释放掉Media资源。而因为停止播放Audio的时间会很长,如果程序因为这个原因而失去AudioFocus,最好不要让它再次自动获得AudioFocus而继续播放,不然突然冒出来的声音会让用户感觉莫名其妙,感受很不好。这里直接放弃AudioFocus,当然也不用再侦听远程播放控制【如下面代码的处理】。要再次播放,除非用户再在界面上点击开始播放,才重新初始化Media,进行播放。
AUDIOFOCUS_LOSS_TRANSIENT:暂时失去AudioFocus,并会很快再次获得。必须停止Audio的播放,但是因为可能会很快再次获得AudioFocus,这里可以不释放Media资源;
AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:暂时失去AudioFocus,但是可以继续播放,不过要降低音量。
(5)典型的应用AudioFocus的场景
下面的时序图描述了AudioFocus被抢占与再次获取的典型场景:
Audio Focus被抢占与再次获取的时序图
注意:为了描述简单,此图中除了两个竞争AudioFocus的App之外,只用AudioManager表征了Android的AudioFocus机制中内部参与的对象,实际AudioManager只是外部的表象,内部参与的对象很多,回调函数也并非简单的直接由AudioManager调用,其中还包含了复杂的IPC机制。
图中:
AudioFocusClient通过requestAudioFocus()获取AudioFocus,在获得AudioFocus之后,开始播放Audio[Step#1 ~ #2];
其它程序(OtherApp)也通过requestAudioFocus()获取AudioFocus [Step#3]
AudioFocusClient失去了Audio Focus,在onAudioFocusChanged()中,根据focusChange【focusChange的值与OtherApp申请时的durationHint相反,即focusChange = -1*durationHint】的值,做第二节中所描述的处理[Step#4];
其它程序(Other App)获取AudioFocus之后,开始播放Audio[Step#5];
其它程序(OtherApp)使用Audio之后,通过abandonAudioFocus()归还AudioFocus [Step#6];
AudioFocusClient重新获得了Audio Focus,可做进一步的处理 [Step#7]
小结
AudioFocus机制要参与各方充分理解并统一遵照施行,有没有遵照者或者实现有误的程序存在就可能打破这一机制,带来糟糕的用户体验。在保证Built-in程序没问题的前提下,如果进入AndroidMarket之前的程序都严格执行了AudioFocus相关的测试,应该也没问题。
使用Audio的程序要做到:
使用前,用requestAudioFocus()申请AudioFocus,并根据应用的实际选取恰当的durationHint值;
正确的在AudioManager.OnAudioFocusChangeListener中响应AudioFocus失去和重新获取事件;
Audio使用结束,用
abandonAudioFocus()
归还AudioFocus。
(6)AudioManager的一般使用
来自 <http://blog.csdn.net/winson_jason/article/details/8126856>
AudioManager除了能在AudioFocus中使用外,最主要的是它能控制声音和铃声
这里只讲述几个比较常用到的方法:
adjustVolume(intdirection, int flags) ——用来控制手机音量大小,当传入的第一个参数为 AudioManager.ADJUST_LOWER时,可将音量调小一个单位,传入AudioManager.ADJUST_RAISE 时,则可以将音量调大一个单位。
adjustStreamVolume(intstreamType, 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(intstreamType, 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(intringerMode) ——改变铃声模式
getStreamVolume(intstreamType) ——取得当前手机的音量,最大值为7,最小值为0,当为0时,手机自动将模式调整为“震动模式”。
getStreamMaxVolume(intstreamType)——获得当前手机最大铃声。
setStreamMute(intstreamType, boolean state)
//音量控制,初始化定义
AudioManagermAudioManager = (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);
}
常用方法:
androidaudioManager获取音量:
先获取AudioManager实例,
AudioManagermAudioManager = (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 );
(7)处理Audio硬件设备
查找正在使用的声音设备
if(isBluetoothA2dpOn()) {
// Adjust output forBluetooth.
} else if(isSpeakerphoneOn()) {
// Adjust output forSpeakerphone.
} else if(isWiredHeadsetOn()) {
// Adjust output for headsets
} else {
// If audio plays and noone can hearit, is it still playing?
}
当耳机设备或蓝牙设备断开连接之后,Audio设备自动切换到喇叭,会发送ACTION_AUDIO_BECOMING_NOISY 广播,注册一个广播接收者用于接收该 广播就可以控制声音播放
private classNoisyAudioStreamReceiver extends BroadcastReceiver {
@Override
public void onReceive(Contextcontext, Intent intent) {
if(AudioManager.ACTION_AUDIO_BECOMING_NOISY.equals(intent.getAction())) {
// Pause the playback
}
}
}
private IntentFilterintentFilter = newIntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
private voidstartPlayback() {
registerReceiver(myNoisyAudioStreamReceiver(), intentFilter);
}
private voidstopPlayback() {
unregisterReceiver(myNoisyAudioStreamReceiver);
}