Android无法捕获android.intent.action.MEDIA_BUTTON事件 如何实现蓝牙耳机按键控制TextToSpeech

问题背景 #

基于TextToSpeech实现文本朗读的Android应用开发接近收尾，仅核心交互环节受阻：需要通过小米运动蓝牙耳机的播放/暂停按键，控制TextToSpeech的播放与暂停操作。

已尝试的方案与异常 #

• 静态注册MEDIA_BUTTON广播接收器
  在AndroidManifest.xml中配置了高优先级的媒体按键广播接收器，代码如下：

  <receiver android:name=".ButtonReceiver">
         <intent-filter android:priority="10000">              
               <action android:name="android.intent.action.MEDIA_BUTTON"/>
         </intent-filter>
  </receiver>
  

  对应的广播接收类仅做Toast调试：

  public class ButtonReceiver extends BroadcastReceiver {
      @Override
      public void onReceive(Context context, Intent intent) {
          Toast.makeText(context, "debug media button test", Toast.LENGTH_LONG).show();
      }
  }
  

  按下蓝牙耳机播放/暂停键时无调试提示。替换intent-filter的action为android.media.VOLUME_CHANGED_ACTION后，按下音量加减键可正常触发Toast，说明蓝牙按键的广播传输通路本身没有问题。
• 调用废弃的注册接口
  补充使用registerMediaButtonEventReceiver接口注册接收器，在MainActivity的onCreate中实现：

  private AudioManager audioManager;
   private ComponentName componentName;
  
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
       audioManager = (AudioManager) this.getSystemService(AUDIO_SERVICE);
       componentName = new ComponentName(this, ButtonReceiver.class);
       audioManager.registerMediaButtonEventReceiver(componentName);
   }
  

  该接口已被标记为废弃，调用后仍无法捕获播放/暂停按键事件。
• 对官方方案的顾虑
  查阅到Android 5.0（API 21）以上版本要求通过MediaSession、MediaController的链路处理媒体按键事件，但认为该方案冗余：应用并非音频播放类应用，仅需要捕获按键事件控制TTS，不想引入整套媒体播放相关模块。

解决方案 #

不需要引入完整的媒体播放模块，最小化实现仅需要正确使用MediaSessionCompat即可，无需关联MediaBrowser、MediaController等冗余组件，代码量远低于预期：

• 依赖准备
  确保项目引入androidx.media:media:1.6.0及以上版本（AndroidX项目默认已包含该依赖）。
• 初始化与事件监听
  在MainActivity的onCreate中完成MediaSessionCompat实例化与回调配置：

  private MediaSessionCompat mediaSession;
  
  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      // 初始化MediaSession，第二个参数为自定义的会话标识
      mediaSession = new MediaSessionCompat(this, "TTS_MEDIA_SESSION");
      // 配置按键事件回调
      mediaSession.setCallback(new MediaSessionCompat.Callback() {
          @Override
          public boolean onMediaButtonEvent(Intent mediaButtonIntent) {
              // 提取按键事件
              KeyEvent event = mediaButtonIntent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
              if (event != null && event.getAction() == KeyEvent.ACTION_DOWN) {
                  int keyCode = event.getKeyCode();
                  // 匹配播放/暂停按键
                  if (keyCode == KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE) {
                      // 在此处实现TTS播放/暂停切换逻辑，替换原有调试Toast
                      Toast.makeText(MainActivity.this, "捕获到播放/暂停按键", Toast.LENGTH_SHORT).show();
                      return true;
                  }
              }
              return super.onMediaButtonEvent(mediaButtonIntent);
          }
      });
      // 必须将会话设为活跃状态，否则无法接收媒体按键事件
      mediaSession.setActive(true);
  }
  

• 资源释放
  在onDestroy回调中释放会话资源，避免内存泄漏：

  @Override
  protected void onDestroy() {
      super.onDestroy();
      mediaSession.setActive(false);
      mediaSession.release();
  }
  

原方案失效原因说明 #

• 静态注册MEDIA_BUTTON广播的模式从Android 5.0开始已被废弃，系统会优先将媒体按键事件路由给当前处于活跃状态的MediaSession，不会再直接向静态注册的接收器发送普通广播。
• 调用废弃的registerMediaButtonEventReceiver本质是系统代为创建隐式MediaSession，但从Android 6.0开始该接口的行为已被修改，无法正常获得媒体按键事件的接收优先级。
• MediaBrowser是面向需要跨应用暴露媒体播放列表的音频应用设计的组件，纯本地TTS应用仅需要独立的MediaSession实例即可获得媒体按键接收权限，完全不需要引入该类冗余模块。

内容的提问来源于stack exchange，提问作者Wakeman