Android Studio开发：如何检测耳机按键与蓝牙耳机按键？

方法一：使用广播接收器（兼容旧版本） #

Android系统会在耳机/蓝牙耳机按键触发时发送ACTION_MEDIA_BUTTON广播，你可以通过注册广播接收器捕获这些事件。

1. 声明权限
   在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.MEDIA_CONTENT_CONTROL" />

2. 实现广播接收器
   创建自定义广播接收器类处理按键事件：

public class MediaButtonReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
            KeyEvent event = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
            if (event != null && event.getAction() == KeyEvent.ACTION_DOWN) {
                switch (event.getKeyCode()) {
                    case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
                        // 处理播放/暂停逻辑
                        break;
                    case KeyEvent.KEYCODE_MEDIA_NEXT:
                        // 处理下一曲逻辑
                        break;
                    case KeyEvent.KEYCODE_MEDIA_PREVIOUS:
                        // 处理上一曲逻辑
                        break;
                    case KeyEvent.KEYCODE_MEDIA_PLAY:
                        // 处理播放逻辑
                        break;
                    case KeyEvent.KEYCODE_MEDIA_PAUSE:
                        // 处理暂停逻辑
                        break;
                }
            }
        }
    }
}

3. 注册接收器

• 静态注册（在Manifest中）：

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

• 动态注册（在Activity/Service中）：

MediaButtonReceiver receiver = new MediaButtonReceiver();
IntentFilter filter = new IntentFilter(Intent.ACTION_MEDIA_BUTTON);
filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY); // 确保优先接收事件
registerReceiver(receiver, filter);

注意：API 21及以上版本，静态注册的广播接收器可能无法正常接收事件，推荐使用动态注册或MediaSession方案。

方法二：使用MediaSessionCompat（推荐，API 21+） #

从Android 5.0开始，官方推荐用MediaSessionCompat处理媒体按键事件，这种方式更稳定，还能和系统媒体控制中心集成。

1. 添加依赖
   在build.gradle中添加MediaCompat依赖：

implementation "androidx.media:media:1.6.0"

2. 初始化MediaSessionCompat
   在Service或Activity中完成初始化：

private MediaSessionCompat mediaSession;

private void initMediaSession() {
    mediaSession = new MediaSessionCompat(this, "MyMP3PlayerSession");
    mediaSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
    
    // 设置回调处理按键事件
    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) {
                switch (event.getKeyCode()) {
                    case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
                        // 处理播放/暂停
                        return true;
                    case KeyEvent.KEYCODE_MEDIA_NEXT:
                        // 处理下一曲
                        return true;
                    case KeyEvent.KEYCODE_MEDIA_PREVIOUS:
                        // 处理上一曲
                        return true;
                }
            }
            return super.onMediaButtonEvent(mediaButtonIntent);
        }
    });
    
    // 激活MediaSession
    mediaSession.setActive(true);
}

3. 处理生命周期
   在组件销毁时释放MediaSession：

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

4. 后台接收事件配置（可选）
   如果需要应用在后台也能接收按键事件，在Manifest中注册官方的MediaButtonReceiver：

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

同时在Service的onStartCommand中处理：

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    MediaButtonReceiver.handleIntent(mediaSession, intent);
    return START_STICKY;
}

注意事项 #

• 蓝牙耳机的按键事件与有线耳机处理逻辑完全一致，无需额外适配。
• 部分蓝牙耳机的长按/短按会触发不同KeyCode，需根据实际测试结果调整逻辑。
• 应用后台运行时，需通过前台Service保持进程活跃才能持续接收事件。

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