田海立
2012-04-03
本文从Audio控制使用的角度,讲解了AudioStream的分类,硬件音量控制键调整对相应AudioStream音量大小的影响,以及如何响应远程MediaButton控制Audio播放。
1. Audio Stream
Android为不同的应用场合定义了不同的Audio Stream: Voice Call, Ring, Music,Alarm, Notification, DTMF。 这些AudioStream是相互独立的,所以也有各自的音量。AudioStream的定义在android.media.AudioManager中,如下图所示:
2. 硬件音量控制键Vol+/-控制Audio Stream的音量
用户按下音量控制的HardKey,希望能调出音量调整的界面。
缺省情况下,按下音量控制的硬件控制键Vol+/-,调节的是当前被激活的(Active)AudioStream的音量,如果你的程序当前没有正在播放任何声音,按下Vol+/-调节的是来电铃声的音量。【笔者注:基本是翻译的原话,需要明确!By default, pressing the volume controls modifythe volume of the active audio stream. If your app isn't currently playing anything, hitting the volume keys adjusts the ringer volume.】
在某一个程序运行时,希望按下Vol+/-调节的是当前所使用的AudioStream的音量,Android在Activity中提供了setVolumeControlStream()方法用来指定你的应用程序使用的Audio Stream类型。所以,如果你的程序用到Audio的播放,你首先要知道你的程序所用的Audio Stream类型,并在onCreate()中调用setVolumeControlStream()来设定Audio Stream的类型。
Q:setVolumeControlStream()之后就起效,还是可见之后才有用?后台播放呢?
要明确这些标红的地方,需要看Android的内部实现!//TODO:明确化;内部实现,另外专题写…
3. 遥控Audio Playback
有些耳机上有诸如音量控制、切换前一首下一首歌、播放/暂停等控制键,Bluetooth的AVRCP Profile也能远程控制的。这些键被按下后,Android是通过broadcast ACTION_MEDIA_BUTTON这个Intent发出去的。
所以,要在你的应用中处理这些按键,只要侦听这个广播,并处理即可。
如果知道什么时候开始侦听广播,程序中动态注册/注销侦听都是很好的选择(与,写在AndroidManifest中,apk加载时就注册相比)。而Audio控制在什么时候才处理这些键值是比较明确的,一般获得AudioFocus的情况下,响应ACTION_MEDIA_BUTTON广播;失去Audio Focus的情况下,不响应ACTION_MEDIA_BUTTON广播,这也就是相应registerMediaButtonEventReceiver()/unregisterMediaButtonEventReceiver()的最佳时机。
ACTION_MEDIA_BUTTON广播的处理,只要在override onReceive(),并在其中通过判断是否Intent.ACTION_MEDIA_BUTTON确保是这个广播,从Intent.EXTA_KEY_EVENT中获得KeyEvent,做相应的处理即可。
涉及的几个类的关系图如下:
相应处理的代码片段如下:
public class RemoteControlReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, 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. } } } }
总结一下要点:
1. Android的Audio控制是按照Audio Stream划分的;
2. 各个Audio Stream的音量是独立的。推荐在onCreate()中通过Activity.setVolumeControlStream()方法设置所使用AudioStream的类型,实现按下硬键Vol+/-调整的是相对应AudioStream的音量;
3. 侦听Intent.ACTION_MEDIA_BUTTON广播实现对远程Media控制的处理。
主要参考资源:
1. Controllingyour app’s volume and playback
2. Android Reference API.