Android中MediaSessionCompat.Callback的onSeekTo()如何检测通知播放器触发事件

核心结论 #

MediaSessionCompat.Callback的onSeekTo()回调无法直接获取跳转操作的来源（相对/绝对），也没有原生API支持为该回调添加上下文信息。不过可以通过以下几种方案绕开这个限制：

可行方案 #

1. 自定义媒体控制逻辑（替代系统默认控件） #

如果章节跳转是应用内的自定义操作，完全可以不依赖系统媒体控件的默认行为：

• 在应用内的章节跳转按钮点击事件中，直接调用播放器的章节跳转方法（比如ExoPlayer的seekToPreviousMediaItem()/seekToNextMediaItem()，若章节以独立MediaItem存在）
• 这种方式无需通过MediaSession回调传递，天然能区分章节相对跳转与绝对位置跳转

2. 维护状态标记区分跳转类型 #

在触发章节跳转前，先设置一个类内状态标记，在onSeekTo()中根据标记判断：

class MyMediaSessionCallbackHandler: MediaSessionCompat.Callback() {
    private var isChapterRelativeSeek = false
    
    // 应用内触发章节跳转时调用此方法
    fun triggerChapterSeek(targetPosition: Long) {
        isChapterRelativeSeek = true
        // 同步MediaSession播放状态
        mediaSession.setPlaybackState(
            PlaybackStateCompat.Builder(playbackState)
                .setState(PlaybackStateCompat.STATE_PLAYING, targetPosition, 1f)
                .build()
        )
        exoPlayer.seekTo(targetPosition)
    }

    override fun onSeekTo(position: Long) {
        if (isChapterRelativeSeek) {
            // 处理章节级逻辑
            handleChapterSeek(position)
            isChapterRelativeSeek = false
        } else {
            // 处理普通绝对位置跳转
            handleNormalSeek(position)
        }
    }
}

注意：该方案仅适用于应用自身触发的章节跳转，第三方设备（如蓝牙音箱）触发的跳转无法通过此方式标记。

3. 利用ExoPlayer章节信息反向推导 #

如果章节信息已配置到ExoPlayer的MediaItem中，可在onSeekTo()中对比当前播放位置与目标位置，判断是否符合章节跳转的偏移规律：

override fun onSeekTo(position: Long) {
    val currentPosition = exoPlayer.currentPosition
    val chapterDuration = getCurrentChapterDuration() // 自定义方法：获取当前章节时长
    val chapterStart = getCurrentChapterStartPosition() // 自定义方法：获取当前章节起始位置
    
    // 判断是否为跳转到上一/下一章节开头
    if (position == chapterStart - chapterDuration || position == chapterStart + chapterDuration) {
        handleChapterSeek(position)
    } else {
        handleNormalSeek(position)
    }
}

局限性：若用户手动拖动进度条到章节边界位置，会被误判为章节跳转。

关于MediaSession添加上下文的说明 #

MediaSession是标准化的媒体控制协议，本身不支持为onSeekTo()回调添加上下文参数。若需自定义控制逻辑，更推荐通过自定义媒体会话命令实现：

// 定义自定义命令常量
const val COMMAND_SEEK_TO_CHAPTER = "com.your.app.SEEK_TO_CHAPTER"

// 在MediaSession中注册支持的自定义命令
mediaSession.setPlaybackState(
    PlaybackStateCompat.Builder(PlaybackStateCompat.STATE_PLAYING)
        .addCustomAction(
            PlaybackStateCompat.CustomAction.Builder(
                COMMAND_SEEK_TO_CHAPTER,
                "章节跳转",
                R.drawable.ic_chapter_seek
            ).build()
        )
        .build()
)

// 在Callback中处理自定义命令
override fun onCustomAction(action: String?, extras: Bundle?) {
    super.onCustomAction(action, extras)
    if (COMMAND_SEEK_TO_CHAPTER == action) {
        val chapterOffset = extras?.getInt("CHAPTER_OFFSET") ?: 0
        // 处理章节跳转逻辑
        seekToChapter(chapterOffset)
    }
}

这种方式能明确区分不同类型的跳转操作，避免混淆。

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