Android 监听耳机按键方式

在 Android 设备上监听耳机按键可以为用户提供更便捷的媒体控制体验。耳机按键通常位于耳机线上或蓝牙耳机的侧边，用户可以通过这些按键轻松地控制媒体播放，例如播放/暂停、下一首、上一首、音量调整等。

1. 使用 MediaSessionManager

简介： MediaSessionManager 是 Android 系统中的一个类，用于管理和控制媒体会话（MediaSession）。它提供了一组方法来检索和操作当前活动的媒体会话，以及与其相关的媒体按钮事件和音频焦点。

步骤：

1. 注册监听

MediaSessionManager mMediaSessionManager;
Handler mMediaKeyHandler;
HandlerThread mMediaThread;


mMediaSessionManager = (MediaSessionManager) mContext.getSystemService(Context.MEDIA_SESSION_SERVICE);
mMediaThread = new HandlerThread("MediaThread");
mMediaThread.start();
mMediaKeyHandler = new Handler(mMediaThread.getLooper());
mMediaSessionManager.setOnMediaKeyListener(mMediaKeyListener, mMediaKeyHandler);

2. 媒体按键监听器

private MediaSessionManager.OnMediaKeyListener mMediaKeyListener =
        new MediaSessionManager.OnMediaKeyListener() {
            @Override
            public boolean onMediaKey(KeyEvent event) {
                int keycode = event.getKeyCode();
                int action = event.getAction();
                if ((keycode == KeyEvent.KEYCODE_HEADSETHOOK)
                        || (keycode == KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE)) {
                    if (action == KeyEvent.ACTION_DOWN) {
                        // handler KeyEvent of KEYCODE_HEADSETHOOK or KEYCODE_MEDIA_PLAY_PAUSE
                    } 
                }
                return true;
            }
        };

3. 取消监听

mMediaKeyHandler.getLooper().quit();
mMediaSessionManager.setOnMediaKeyListener(null, null);
MediaThread.quit();

4. 耳机按键事件

KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE: 播放/暂停
KeyEvent.KEYCODE_MEDIA_NEXT: 下一首
KeyEvent.KEYCODE_MEDIA_PREVIOUS: 上一首
KeyEvent.KEYCODE_MEDIA_STOP: 停止
KeyEvent.KEYCODE_MEDIA_FAST_FORWARD: 快进
KeyEvent.KEYCODE_MEDIA_REWIND: 快退
KeyEvent.KEYCODE_HEADSETHOOK：耳机挂机键

2. 使用 MediaSessionCompat

简介： MediaSessionCompat 是 AndroidX 提供的 API，用于控制媒体播放。它可以用来监听耳机上的播放/暂停、上一首/下一首等按键事件。

步骤：

1. 在项目中添加依赖：

implementation 'androidx.media:media:1.4.0'

2. 创建 MediaSessionCompat 对象：

MediaSessionCompat mediaSession = new MediaSessionCompat(context, "MySession");

3. 设置 MediaSessionCompat 的回调函数：

mediaSession.setCallback(new MediaSessionCompat.Callback() {
    @Override
    public void onPlay() {
        // 处理播放事件
    }

    @Override
    public void onPause() {
        // 处理暂停事件
    }

    @Override
    public void onSkipToPrevious() {
        // 处理上一首事件
    }

    @Override
    public void onSkipToNext() {
        // 处理下一首事件
    }
});

4. 在 Activity 的 onResume() 方法中启动 MediaSessionCompat：

@Override
protected void onResume() {
    super.onResume();
    mediaSession.setActive(true);
}

5. 在 Activity 的 onPause() 方法中停止 MediaSessionCompat：

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

6. 在 Activity 的 onDestroy() 方法中释放 MediaSessionCompat：

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

3. Android 媒体框架官方文档

[1] 媒体应用架构概览
[2] 响应媒体按钮