如何在Jetpack Compose中实现Android第三方音频播放控制？

一、核心通用方案：基于MediaSession框架 #

耳机等外设的播放控制逻辑，本质就是依托Android的MediaSession体系实现的，这也是无需对接各应用专属API的最优解：

• 任何前台播放的音频应用（Spotify、Audible等）都会自动向系统注册MediaSession，系统会维护当前活跃的媒体会话
• 你的启动器只需通过MediaControllerCompat（或Jetpack Media3的MediaController）绑定到当前活跃会话，就能直接发送播放/暂停/切歌等控制指令

二、通知控制的具体交互逻辑 #

通过通知栏控制媒体播放，底层还是基于MediaSession的回调机制，实际实现时无需手动处理通知：

1. 监听系统的媒体会话变化，获取当前活跃会话对应的MediaControllerCompat
2. 通过MediaControllerCompat.getTransportControls()拿到TransportControls实例，调用play()/pause()/skipToPrevious()/skipToNext()即可发送控制指令
3. 若要同步播放状态，注册MediaControllerCompat.Callback监听会话的播放状态、元数据变化即可

三、Jetpack Compose下的实现示例 #

以下是基于Jetpack Media3（官方推荐替代旧MediaSessionCompat的框架）的Compose实现：

import android.content.Context
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.width
import androidx.compose.material.Icon
import androidx.compose.material.IconButton
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Pause
import androidx.compose.material.icons.filled.PlayArrow
import androidx.compose.material.icons.filled.SkipNext
import androidx.compose.material.icons.filled.SkipPrevious
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.unit.dp
import androidx.media3.session.MediaController
import androidx.media3.session.SessionToken
import com.google.common.util.concurrent.ListenableFuture
import com.google.common.util.concurrent.MoreExecutors

@Composable
fun MediaControlWidget() {
    val context = LocalContext.current
    var mediaController by remember { mutableStateOf<MediaController?>(null) }
    var isPlaying by remember { mutableStateOf(false) }

    // 绑定当前活跃媒体会话
    DisposableEffect(context) {
        val sessionToken = SessionToken(context, SessionToken.TYPE_CURRENT_MEDIA_SESSION)
        val controllerFuture: ListenableFuture<MediaController> =
            MediaController.Builder(context, sessionToken).buildAsync()

        controllerFuture.addListener({
            mediaController = controllerFuture.get()
            // 监听播放状态更新
            mediaController?.addListener(object : MediaController.Listener {
                override fun onPlaybackStateChanged(playbackState: androidx.media3.common.PlaybackState) {
                    isPlaying = playbackState.isPlaying
                }
            })
        }, MoreExecutors.directExecutor())

        // 组件销毁时释放资源
        onDispose {
            mediaController?.release()
        }
    }

    Row {
        IconButton(
            onClick = { mediaController?.transportControls?.skipToPrevious() },
            enabled = mediaController != null
        ) {
            Icon(Icons.Default.SkipPrevious, contentDescription = "上一曲")
        }

        Spacer(modifier = Modifier.width(8.dp))

        IconButton(
            onClick = {
                mediaController?.transportControls?.run {
                    if (isPlaying) pause() else play()
                }
            },
            enabled = mediaController != null
        ) {
            Icon(
                imageVector = if (isPlaying) Icons.Default.Pause else Icons.Default.PlayArrow,
                contentDescription = if (isPlaying) "暂停" else "播放"
            )
        }

        Spacer(modifier = Modifier.width(8.dp))

        IconButton(
            onClick = { mediaController?.transportControls?.skipToNext() },
            enabled = mediaController != null
        ) {
            Icon(Icons.Default.SkipNext, contentDescription = "下一曲")
        }
    }
}

关键注意点： #

• 添加依赖：implementation "androidx.media3:media3-session:1.2.0"
• 权限声明：Android 12及以下需添加android.permission.MEDIA_CONTENT_CONTROL，Android 13+无需
• 空状态处理：当没有活跃音频应用时，mediaController会为空，需禁用控制按钮或隐藏组件

四、备选方案：系统广播（不推荐） #

若不想依赖MediaSession框架，可尝试发送系统媒体控制广播，但兼容性差，无法获取播放状态：

• 发送Intent.ACTION_MEDIA_PLAY_PAUSE、Intent.ACTION_MEDIA_PREVIOUS、Intent.ACTION_MEDIA_NEXT广播
• 部分应用可能不响应此类广播，仅作为极端场景下的兜底方案

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