如何在Media3中不使用MediaSessionConnector手动处理媒体按钮操作？

问题背景 #

之前使用MediaSessionCompat搭配MediaSessionConnector处理媒体按钮指令，迁移到Media3后移除了MediaSessionConnector，原有自定义逻辑（切换应用内音视频片段、双击快进等）无法正常工作：

• 注册自定义android.intent.action.MEDIA_BUTTON广播接收器未触发，因为Media3的MediaSession已内置注册该广播，且仅支持基础播放/暂停操作；
• 同时保留MediaSessionCompat并设置onMediaButtonEvent回调，该回调也未触发。

原有处理逻辑代码：

mediaSessionConnector.setMediaButtonEventHandler { player, mediaButtonEvent ->
    val event: KeyEvent? = mediaButtonEvent.getParcelableExtra(Intent.EXTRA_KEY_EVENT)
    when (event?.keyCode) {
        KeyEvent.KEYCODE_MEDIA_NEXT -> {
            if (event.action == KeyEvent.ACTION_UP) {
                nextSegment()
            }
            true
        }
        KeyEvent.KEYCODE_MEDIA_PREVIOUS -> {
            if (event.action == KeyEvent.ACTION_UP) {
                previousSegment()
            }
            true
        }
        KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE -> {
            if (event.action == KeyEvent.ACTION_UP) {
                onPlayPause()
            }
            true
        }
        else -> false
    }
}

可行解决方案 #

方法一：重写Media3 MediaSession的Callback拦截事件 #

Media3的MediaSession允许通过自定义Callback直接拦截媒体按钮事件，无需额外注册广播或保留旧的MediaSessionCompat，是最简洁的实现方式。

示例代码：

// 记录双击时间戳，用于处理双击快进逻辑
private var lastNextClickTime: Long = 0
private val DOUBLE_CLICK_THRESHOLD = 300 // 双击间隔阈值，单位ms

// 创建MediaSession时设置自定义Callback
val mediaSession = MediaSession.Builder(context, player).apply {
    setCallback(object : MediaSession.Callback {
        override fun onMediaButtonEvent(mediaButtonEvent: Intent): Boolean {
            val keyEvent = mediaButtonEvent.getParcelableExtra<KeyEvent>(Intent.EXTRA_KEY_EVENT) ?: return false
            
            // 只处理ACTION_UP事件，避免重复触发
            if (keyEvent.action != KeyEvent.ACTION_UP) return false
            
            return when (keyEvent.keyCode) {
                KeyEvent.KEYCODE_MEDIA_NEXT -> {
                    val currentTime = System.currentTimeMillis()
                    // 判断是否为双击
                    if (currentTime - lastNextClickTime < DOUBLE_CLICK_THRESHOLD) {
                        // 双击快进逻辑
                        fastForward()
                    } else {
                        // 单击切换下一个片段
                        nextSegment()
                    }
                    lastNextClickTime = currentTime
                    true // 返回true表示已拦截事件，Media3不再处理默认逻辑
                }
                KeyEvent.KEYCODE_MEDIA_PREVIOUS -> {
                    previousSegment()
                    true
                }
                KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE -> {
                    onPlayPause()
                    true
                }
                else -> false // 返回false让Media3处理默认逻辑
            }
        }
    })
}.build()

方法二：替换Media3内置的媒体按钮接收器（可选） #

如果需要完全接管媒体按钮广播，可以在创建MediaSession时传入自定义广播接收器，替换Media3内置的接收器：

val mediaSession = MediaSession.Builder(context, player).apply {
    // 传入自定义广播接收器的ComponentName
    setMediaButtonReceiver(ComponentName(context, CustomMediaButtonReceiver::class.java))
}.build()

实现自定义广播接收器：

class CustomMediaButtonReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (Intent.ACTION_MEDIA_BUTTON == intent?.action) {
            val keyEvent = intent.getParcelableExtra<KeyEvent>(Intent.EXTRA_KEY_EVENT) ?: return
            // 在这里处理自定义逻辑，比如分发到ViewModel或直接调用业务方法
            handleMediaButtonEvent(keyEvent)
        }
    }
}

静态注册接收器（AndroidManifest.xml）：

<receiver
    android:name=".CustomMediaButtonReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_BUTTON" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</receiver>

关键说明 #

• 优先使用方法一，直接利用Media3的回调机制，逻辑更简洁，无需额外组件；
• 双击等复杂操作需要自行维护时间戳判断点击间隔；
• 返回true表示已处理事件，Media3不会执行默认逻辑；返回false则会让Media3继续处理该事件。

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