Jetpack Compose实现后台音乐通知跳转与播放器状态同步

要实现点击通知跳转至MusicPlayer页面并保持播放状态同步，核心是让后台Service完全持有播放器实例，UI层仅通过绑定Service获取实例并同步状态，结合DeepLink完成精准跳转。以下是针对你现有代码的优化方案：

一、修正Service的PendingIntent与进度传递 #

播放器的当前进度是Long类型，需调整URI参数类型，确保跳转时传递准确的播放位置：

private fun pendingIntent(): PendingIntent? {
    val currentPosition = player?.currentPosition ?: 0L
    return TaskStackBuilder.create(this).run {
        addNextIntentWithParentStack(
            Intent(Intent.ACTION_VIEW, "music://music_player_screen/$currentPosition".toUri())
        )
        getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE)
    }
}

二、完善Manifest的DeepLink配置 #

需明确指定处理DeepLink的Activity为NavigationActivity，拆分intent-filter避免冲突：

<activity
    android:name=".NavigationActivity"
    android:exported="true">
    <!-- 启动入口 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- DeepLink处理 -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="music" android:host="music_player_screen" />
    </intent-filter>
</activity>

三、调整Navigation Compose的路由配置 #

将进度参数类型改为Long（匹配播放器的currentPosition类型），并优化Service绑定逻辑避免重复绑定：

composable(
    route = Screens.MusicPlayer.route + "/{currentPosition}",
    deepLinks = listOf(
        navDeepLink {
            uriPattern = "music://music_player_screen/{currentPosition}"
        }
    ),
    arguments = listOf(
        navArgument("currentPosition") { 
            type = NavType.LongType
            defaultValue = 0L
        }
    )
) { backStackEntry ->
    val currentPosition = backStackEntry.arguments?.getLong("currentPosition") ?: 0L
    
    // 仅在首次进入时绑定Service
    LaunchedEffect(Unit) {
        if (!isServiceBound) {
            bindMusicService()
        }
    }

    MusicPlayerActivity(
        activity = this@NavigationActivity,
        navController = navController,
        currentPosition = currentPosition
    )
}

四、重构MusicPlayer页面，避免重置播放器状态 #

删除页面中重复初始化播放器的代码（prepare()、setMediaItem()等），仅通过绑定Service获取实例并同步进度：

@Composable
fun MusicPlayerActivity(
    activity: NavigationActivity,
    navController: NavController,
    currentPosition: Long
) {
    // 保留原有UI相关的remember变量
    val playerBackground by remember { mutableStateOf(MusicPlayerData.playerBackground) }
    val headerIcon by remember { mutableStateOf(MusicPlayerData.headerIcon) }
    // ... 其他UI变量 ...

    // 绑定Service获取播放器实例
    val playerService = rememberBoundLocalService<PlayerService, PlayerService.ServiceBinder> {
        this.getPlayerService()
    }
    val player = playerService?.player

    // 同步跳转时传递的播放进度
    LaunchedEffect(player, currentPosition) {
        player?.let {
            if (it.currentPosition != currentPosition) {
                it.seekTo(currentPosition)
            }
        }
    }

    // 监听播放器状态，实时更新UI
    val playbackState by remember { mutableStateOf(player?.playbackState) }
    val currentPlayPosition by remember { mutableStateOf(player?.currentPosition) }
    
    DisposableEffect(player) {
        val listener = object : Player.Listener {
            override fun onPlaybackStateChanged(playbackState: Int) {
                // 更新播放状态（缓冲/就绪/结束）
            }
            override fun onPositionDiscontinuity(
                oldPosition: Player.PositionInfo,
                newPosition: Player.PositionInfo,
                reason: Int
            ) {
                // 更新实时播放进度
            }
        }
        player?.addListener(listener)
        onDispose {
            player?.removeListener(listener)
            // 不要在此释放播放器，由Service管理生命周期
        }
    }

    // 原有UI布局代码，修改按钮逻辑直接操作Service中的player
    ConstraintLayout(modifier = Modifier.fillMaxSize()) {
        // ... 原有UI组件 ...
        Row(/* ... */) {
            Image(
                modifier = Modifier
                    .size(80.dp)
                    .noRippleClickable { player?.seekTo(0) },
                painter = painterResource(id = rewind),
                contentDescription = "倒带"
            )
            Image(
                modifier = Modifier
                    .size(80.dp)
                    .noRippleClickable { player?.pause() },
                painter = painterResource(id = pause),
                contentDescription = "暂停"
            )
            // ... 其他按钮 ...
        }
    }
}

五、优化NavigationActivity的Service绑定逻辑 #

移除onBackPressed()中释放播放器的代码，让Service独立管理后台播放生命周期：

override fun onBackPressed() {
    if (isServiceBound) {
        isServiceBound = false
        unbindService(playerServiceConnection)
        // 仅解绑Service，不停止/释放播放器，后台继续播放
    }
    super.onBackPressed()
}

核心要点总结 #

1. 单一数据源：播放器实例完全由后台Service持有，UI层仅通过绑定获取实例，避免重复初始化导致状态丢失。
2. 状态同步：通过DeepLink传递当前播放进度，跳转后直接同步到Service中的播放器。
3. UI响应：监听播放器状态变化，实时更新进度条、播放按钮等UI元素。
4. 生命周期分离：UI层仅负责绑定/解绑Service，播放器的创建、释放由Service自行处理。

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