Android 平台检测蓝牙耳机按键按压事件的相关问题咨询

重写onKeyDown、dispatchKeyEvent方法仅能捕获普通有线耳机的按键事件，无法捕获蓝牙耳机按键的核心原因是：蓝牙耳机的媒体按键事件默认通过媒体会话链路分发，不会走常规的Activity按键分发流程。旧版文档中提到的AudioManager.registerMediaButtonEventReceiver等接口已在API 21之后废弃，目前官方推荐使用MediaSession方案实现全设备兼容。

具体实现步骤 #

• 步骤1：在AndroidManifest.xml中注册媒体按钮接收器
  在<application>节点下添加如下配置：

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

• 步骤2：初始化MediaSession实例并配置回调
  在需要接收按键事件的页面/服务的onCreate生命周期中完成初始化：

// 初始化MediaSession，第二个参数为自定义标记字符串
val mediaSession = MediaSession(this, "BluetoothKeyMonitor")
// 激活MediaSession，允许接收媒体按键事件
mediaSession.isActive = true
// 配置事件回调处理按键逻辑
mediaSession.setCallback(object : MediaSession.Callback() {
    override fun onMediaButtonEvent(mediaButtonEvent: Intent?): Boolean {
        val keyEvent = mediaButtonEvent?.getParcelableExtra<KeyEvent>(Intent.EXTRA_KEY_EVENT)
        keyEvent?.takeIf { it.action == KeyEvent.ACTION_DOWN }?.run {
            when(keyCode) {
                KeyEvent.KEYCODE_HEADSETHOOK -> {
                    // 处理蓝牙耳机多功能键按下逻辑
                }
                KeyEvent.KEYCODE_MEDIA_PLAY -> {
                    // 处理播放键按下逻辑
                }
                KeyEvent.KEYCODE_MEDIA_PAUSE -> {
                    // 处理暂停键按下逻辑
                }
                KeyEvent.KEYCODE_MEDIA_NEXT -> {
                    // 处理下一曲键按下逻辑
                }
                KeyEvent.KEYCODE_MEDIA_PREVIOUS -> {
                    // 处理上一曲键按下逻辑
                }
            }
        }
        // 返回true表示事件已被消费，不会继续向下分发
        return true
    }
})

• 步骤3：资源回收
  在页面/服务销毁时释放MediaSession，避免内存泄漏：

override fun onDestroy() {
    super.onDestroy()
    mediaSession.release()
}

适配注意事项 #

• 部分定制ROM会默认将蓝牙耳机按键事件优先分发给系统默认音乐应用，应用在前台时主动申请音频焦点即可获得事件优先处理权
• Android 12及以上版本需要提前申请android.permission.BLUETOOTH_CONNECT动态权限，否则无法正常接收蓝牙耳机相关事件
• 按键的单击、双击、长按区分可以通过统计KeyEvent的事件间隔、重复次数实现，无需引入额外依赖

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