android音视频指南-响应媒体按钮

翻译自：Responding to media buttons

媒体按钮是Android设备和其他外围设备上的硬件按钮，例如蓝牙耳机上的暂停/播放按钮。当用户按下媒体按钮时，Android会生成一个KeyEvent，其中包含一个识别按钮的密钥代码。media button KeyEvents的关键代码是以KEYCODE_MEDIA开头的常量(例如，KEYCODE_MEDIA_PLAY)。

应用程序应该能够在三种情况下处理媒体按钮事件，按优先顺序排列:

当应用程序的UI活动可见时
当UI活动隐藏且应用程序的媒体会话处于活动状态时
当UI活动被隐藏，应用程序的媒体会话不活跃，需要重新启动时

处理前台活动中的媒体按钮

前台活动在其onKeyDown()方法中接收media button key事件。根据Android的运行版本，系统有两种方式将事件路由到媒体控制器:

如果你运行的是安卓5.0 (API level 21)或更高版本，调用FLAG_HANDLES_MEDIA_BUTTONS MediaBrowserCompat.ConnectionCallback.onConnected。这将自动调用您的媒体控制器的dispatchMediaButtonEvent()，它将关键代码转换为媒体会话回调。
在Android 5.0 (API level 21)之前，您需要修改onKeyDown()来自己处理事件。(有关详细信息，请参阅Handling media buttons in an active media session。)下面的代码片段展示了如何截获关键代码并调用dispatchMediaButtonEvent()。确保返回true以指示事件已处理:

@Override
    boolean onKeyDown(int keyCode, KeyEvent event) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
              return super.onKeyDown(keyCode, event);
            }
            switch (keyCode) {
              case KeyEvent.KEYCODE_MEDIA_PLAY:
                      yourMediaController.dispatchMediaButtonEvent(event);
                      return true;
            }
            return super.onKeyDown(keyCode, event);
    }

寻找媒体会话

如果前台活动不处理事件，Android将尝试找到一个可以处理它的媒体会话。同样，根据Android的运行版本，有两种方法可以搜索媒体会话:

如果你运行的是安卓8.0 (API level 26)或更高版本，系统会试图找到最后一个带有本地播放音频的MediaSession的应用。如果会话仍然是活动的，Android会将事件直接发送到它。否则，如果会话不是活动的，并且它有一个mediabutton接收器，Android将事件发送给接收器，接收器将重新启动会话，因此它可以接收事件。(有关详细信息，请参阅Using media buttons to restart an inactive media session 。)如果会话没有媒体按钮接收器，系统将丢弃媒体按钮事件，并且什么也不会发生。逻辑如下图所示:
在Android 8.0 (API级别26)之前，系统尝试将事件发送到活动媒体会话。如果有多个活动媒体会话，Android会尝试选择准备播放(缓冲/连接)、播放或暂停的媒体会话，而不是停止的。(有关更多细节，请参见 Handling media buttons in an active media session。)如果没有活动会话，Android会尝试将事件发送到最近的活动会话。(有关详细信息，请参阅使用Using media buttons to restart an inactive media session。)逻辑如下图所示:

处理活动媒体会话中的媒体按钮

在Android 5.0 (API level 21)及更高版本上，Android通过调用onMediaButtonEvent()自动将媒体按钮事件分派给您的活动媒体会话。默认情况下，此回调将KeyEvent转换为与密钥代码匹配的适当的媒体会话回调方法。

在Android 5.0 (API level 21)之前，Android通过使用ACTION_MEDIA_BUTTON操作广播一个意图来处理媒体按钮事件。你的应用程序必须注册一个广播接收器来拦截这些意图。MediaButtonReceiver类是专门为此目的设计的。它是Android media-compat库中的一个方便类，它处理ACTION_MEDIA_BUTTON并将传入的意图转换为适当的MediaSessionCompat.Callback方法调用。

MediaButtonReceiver是一个短命的广播接收器。它将传入的意图转发给管理媒体会话的服务。如果你想在Android 5.0之前在系统中使用媒体按钮，你必须在清单中包括MediaButtonReceiver和MEDIA_BUTTON意图过滤器。

<receiver android:name="android.support.v4.media.session.MediaButtonReceiver" >
   <intent-filter>
     <action android:name="android.intent.action.MEDIA_BUTTON" />
   </intent-filter>
 </receiver>

广播接收器将意图转发给您的服务。要解析意图并生成对媒体会话的回调，请在服务的onStartCommand()中包含MediaButtonReceiver.handleIntent()方法。这将把关键代码转换为适当的会话回调方法。

private MediaSessionCompat mMediaSessionCompat = ...;

public int onStartCommand(Intent intent, int flags, int startId) {
  MediaButtonReceiver.handleIntent(mMediaSessionCompat, intent);
  return super.onStartCommand(intent, flags, startId);
}

注意:如果您没有MediaBrowserServiceCompat，您还可以向任何服务添加ACTION_MEDIA_BUTTON意图过滤器。有关更多信息，请参阅MediaButtonReceiver文档。

使用媒体按钮重新启动非活动的媒体会话

如果Android能够识别最后一个活动媒体会话，它会试图通过发送一个ACTION_MEDIA_BUTTON意图到一个声明注册的组件(如服务或广播接收器)来重新启动会话。

这可以让你的应用在UI不可见时重启回放，这是大多数音频应用的情况。

当您使用MediaSessionCompat时，将自动启用此行为。如果你使用Android框架的MediaSession或者Support Library 24.0.0到25.1.1，你必须调用setMediaButtonReceiver，让媒体按钮重新启动一个非活动的媒体会话。

你可以通过设置一个空媒体按钮接收器，在Android 5.0 (API级别21)或更高版本中禁用此行为:

// Create a MediaSessionCompat
mMediaSession = new MediaSessionCompat(context, LOG_TAG);
mMediaSession.setMediaButtonReceiver(null);

注意:对于在Android 5.0 (API level 21)之前的系统中运行的应用程序，您注册以处理活动会话的媒体按钮的MediaButtonReceiver也会在会话不活动时接收媒体按钮事件。无法禁用此行为。

定制媒体按钮处理程序

onMediaButtonEvent()的默认行为提取关键代码并使用媒体会话的当前状态和支持的操作列表来确定调用哪个方法。例如，KEYCODE_MEDIA_PLAY调用onPlay()。

为了在所有应用程序中提供一致的媒体按钮体验，您应该使用默认行为，并且只为了特定的目的而偏离。如果媒体按钮需要自定义处理，重写回调函数的onMediaButtonEvent()方法，使用intent.getparcelableextra (Intent.EXTRA_KEY_EVENT)提取KeyEvent，自己处理事件，并返回true。

总结

要正确处理Android所有版本中的媒体按钮事件，必须在创建媒体会话时指定FLAG_HANDLES_MEDIA_BUTTONS。

此外，根据您计划支持的Android版本，您还必须满足以下要求:

运行Android 5.0或更高版本时:

从媒体控制器onConnected()回调中调用MediaControllerCompat.setMediaController()
要允许媒体按钮重新启动非活动会话，可以通过调用setMediaButtonReceiver()并传递PendingIntent动态创建MediaButtonReceiver

当系统运行时间早于Android 5.0时:

重写活动的onKeyDown()以处理媒体按钮
静态创建一个MediaButtonReceiver通过添加它到应用程序的清单