Android媒体通知上/下一曲按钮无响应：MediaSessionCompat回调未触发

看起来你已经搞定了播放/暂停的回调触发，但上一曲、下一曲按钮没反应，核心问题出在你的MediaSession没有明确声明支持跳过操作——系统只有确认MediaSession能处理这些操作时，才会把通知按钮的点击事件传递到对应的回调方法里。下面是具体的修复步骤：

1. 在setMediaPlaybackState中添加支持的操作 #

你需要在构建PlaybackStateCompat时，明确添加跳过操作的声明，让系统知道你的Session可以处理这些指令。修改你的setMediaPlaybackState方法如下：

private void setMediaPlaybackState(int state) {
    PlaybackStateCompat.Builder playbackStateBuilder = new PlaybackStateCompat.Builder();

    // 为每个支持的操作添加Action定义
    playbackStateBuilder.addAction(new PlaybackStateCompat.Action(
            PlaybackStateCompat.ACTION_SKIP_TO_PREVIOUS,
            "Previous",
            0));
    playbackStateBuilder.addAction(new PlaybackStateCompat.Action(
            PlaybackStateCompat.ACTION_SKIP_TO_NEXT,
            "Next",
            0));
    playbackStateBuilder.addAction(new PlaybackStateCompat.Action(
            PlaybackStateCompat.ACTION_PLAY_PAUSE,
            "Play/Pause",
            0));

    // 设置操作掩码，包含所有你要支持的操作类型
    long supportedActions = PlaybackStateCompat.ACTION_SKIP_TO_PREVIOUS 
                          | PlaybackStateCompat.ACTION_SKIP_TO_NEXT 
                          | PlaybackStateCompat.ACTION_PLAY_PAUSE;
    playbackStateBuilder.setActions(supportedActions);

    // 设置当前播放状态和其他参数
    playbackStateBuilder.setState(state, PlaybackStateCompat.PLAYBACK_POSITION_UNKNOWN, 1.0f);
    mMediaSessionCompat.setPlaybackState(playbackStateBuilder.build());
}

2. 确保MediaSession初始化时设置正确的Flags #

在创建mMediaSessionCompat的地方，需要开启媒体按钮和传输控制的处理权限：

mMediaSessionCompat = new MediaSessionCompat(this, "BackgroundAudioService");
// 开启必要的Flags，让Session能处理媒体按钮和传输控制指令
mMediaSessionCompat.setFlags(
        MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS 
        | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
mMediaSessionCompat.setCallback(mMediaSessionCallback);

3. 检查Manifest中是否注册了MediaButtonReceiver #

MediaButtonReceiver负责将媒体按钮事件转发给你的MediaSession，需要在AndroidManifest.xml的<service>标签内添加这个接收器：

<service android:name=".BackgroundAudioService">
    <!-- 其他Service配置 -->
    <receiver android:name="androidx.media.session.MediaButtonReceiver">
        <intent-filter>
            <action android:name="android.intent.action.MEDIA_BUTTON" />
        </intent-filter>
    </receiver>
</service>

完成以上修改后，通知栏的上一曲、下一曲按钮点击事件应该就能正常触发onSkipToPrevious()和onSkipToNext()回调了。本质上就是要让系统明确知道你的MediaSession具备处理这些操作的能力，这样事件分发机制才会把对应的指令传递过来。

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