Android 7.1.2下三星耳机Hook键无法触发MediaSession onPlay问题求助

我来帮你拆解这个棘手的问题——相同的代码在低版本Android上运行正常，偏偏在7.1.2搭配三星单键耳机时，明明能收到MediaButton事件，却触发不了onPlay回调。咱们一步步梳理可能的原因和排查方向：

核心推测原因 #

Android 7.0之后，MediaSession对按键事件的解析逻辑做了调整，尤其针对不同耳机的按键码映射差异。你的三星旧耳机可能发送的按键码并非系统默认映射到ACTION_PLAY的类型，导致MediaSession的默认回调未被触发，但原始的onMediaButtonEvent能捕获到事件本身。

具体排查方向 #

1. 打印三星耳机按键的KeyEvent详细参数 #

先把你注释掉的onMediaButtonEvent代码恢复，补充打印更多关键参数，重点看按键码、动作类型：

@Override
public boolean onMediaButtonEvent(Intent mediaButtonEvent) {
    KeyEvent event = (KeyEvent)mediaButtonEvent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
    Log.d("MediaButtonDebug", "KeyCode: " + event.getKeyCode() 
          + " | Action: " + event.getAction() 
          + " | RepeatCount: " + event.getRepeatCount());
    if(event.getAction() == KeyEvent.ACTION_DOWN) {
        toggleRecogniserState();
    }
    return true;
}

重点关注getKeyCode()的返回值：

• 常规播放/暂停键通常对应KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE或KeyEvent.KEYCODE_HEADSETHOOK
• 如果三星耳机发送的是其他按键码（比如旧设备的自定义码，或KEYCODE_HEADSETHOOK被系统映射为其他动作），MediaSession的默认回调就不会触发onPlay，因为它只处理预设映射的按键动作。

2. 扩展PlaybackState支持的动作范围 #

你当前代码仅设置了ACTION_PLAY：

mStateBuilder = new PlaybackStateCompat.Builder()
    .setActions(PlaybackStateCompat.ACTION_PLAY);

如果三星耳机的按键对应的是ACTION_PLAY_PAUSE或ACTION_TOGGLE_PLAYBACK（部分旧设备的逻辑），而你的PlaybackState未声明支持这些动作，MediaSession可能不会将事件转发到对应回调。可以尝试添加常用媒体按键动作：

mStateBuilder = new PlaybackStateCompat.Builder()
    .setActions(PlaybackStateCompat.ACTION_PLAY 
                | PlaybackStateCompat.ACTION_PAUSE 
                | PlaybackStateCompat.ACTION_PLAY_PAUSE
                | PlaybackStateCompat.ACTION_STOP);

3. 验证Android 7.1.2的MediaSession按键映射逻辑 #

Android 7.x开始，系统对MediaButton事件的分发和映射更严格：

• 系统会先检查MediaSession的PlaybackState中声明的Actions，如果事件对应的动作不在其中，可能不会触发对应回调
• 部分旧耳机的KEYCODE_HEADSETHOOK事件，在高版本系统中可能默认映射为ACTION_PLAY_PAUSE而非ACTION_PLAY，而你的代码仅监听ACTION_PLAY，因此未触发。

4. 手动映射按键码到目标回调 #

如果发现三星耳机的按键码是KEYCODE_HEADSETHOOK或其他非标准播放键，可以在onMediaButtonEvent中手动判断并调用对应回调：

@Override
public boolean onMediaButtonEvent(Intent mediaButtonEvent) {
    KeyEvent event = (KeyEvent)mediaButtonEvent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
    if (event.getAction() == KeyEvent.ACTION_DOWN) {
        switch (event.getKeyCode()) {
            case KeyEvent.KEYCODE_HEADSETHOOK:
            case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
                // 根据当前播放状态判断调用onPlay还是onPause
                if (isPlaying()) {
                    onPause();
                } else {
                    onPlay();
                }
                return true;
            case KeyEvent.KEYCODE_MEDIA_PLAY:
                onPlay();
                return true;
        }
    }
    return super.onMediaButtonEvent(mediaButtonEvent);
}

这样就能绕过系统默认映射，直接处理耳机的按键事件。

总结 #

最可能的原因是三星旧耳机的按键码在Android 7.1.2中未被系统映射到ACTION_PLAY，且你的PlaybackState未覆盖对应动作。通过打印KeyEvent细节、扩展PlaybackState的Actions，或手动映射按键码，应该能解决这个问题。

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