Android 13通知栏默认PlaybackStateCompat播放/暂停图标替换问题

Android 13的媒体通知栏会根据PlaybackStateCompat的状态自动映射默认播放/暂停图标，直接移除默认ACTION_PLAY/ACTION_PAUSE并添加自定义Action无法覆盖这个默认行为——系统会优先识别标准播放状态对应的操作，这也是你添加自定义Action后图标显示异常的原因。

正确实现步骤 #

1. 保留标准播放/暂停Action，替换通知内图标 #

系统媒体控件会根据当前播放状态自动切换图标，你可以通过MediaStyle通知直接指定自定义图标：

// 构建播放/暂停Action，传入自定义图标资源
val playPauseAction = if (isPlaying) {
    NotificationCompat.Action(
        R.drawable.ic_custom_pause, // 自定义暂停图标
        "暂停",
        MediaButtonReceiver.buildMediaButtonPendingIntent(context, PlaybackStateCompat.ACTION_PAUSE)
    )
} else {
    NotificationCompat.Action(
        R.drawable.ic_custom_play, // 自定义播放图标
        "播放",
        MediaButtonReceiver.buildMediaButtonPendingIntent(context, PlaybackStateCompat.ACTION_PLAY)
    )
}

// 配置MediaStyle并关联媒体会话
val mediaStyle = androidx.media.app.NotificationCompat.MediaStyle()
    .setShowActionsInCompactView(0) // 指定紧凑视图显示的Action索引
    .setMediaSession(mediaSession.sessionToken)

// 构建最终通知
val notification = NotificationCompat.Builder(context, MEDIA_CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_notification_small)
    .setStyle(mediaStyle)
    .addAction(playPauseAction)
    .build()

2. 同步PlaybackState状态 #

确保PlaybackStateCompat.Builder正确设置播放状态，让系统能匹配对应的Action行为：

val playbackState = PlaybackStateCompat.Builder()
    .setState(
        if (isPlaying) PlaybackStateCompat.STATE_PLAYING else PlaybackStateCompat.STATE_PAUSED,
        PlaybackStateCompat.PLAYBACK_POSITION_UNKNOWN,
        1.0f
    )
    .addAction(PlaybackStateCompat.ACTION_PLAY)
    .addAction(PlaybackStateCompat.ACTION_PAUSE)
    // 按需添加其他标准Action（如ACTION_SKIP_TO_NEXT等）
    .build()

mediaSession.setPlaybackState(playbackState)

3. 避免自定义Action冲突 #

不要用自定义Action替换标准的ACTION_PLAY/ACTION_PAUSE，因为Android媒体框架会将自定义Action识别为额外操作（比如随机播放、循环模式），这就是你之前看到图标显示异常的核心原因。

额外注意事项 #

• 自定义图标建议使用24dp矢量图，符合Android媒体控件的尺寸规范，避免拉伸或显示变形。
• Android 13+的媒体通知样式受系统主题影响，需在不同主题环境下测试显示效果。
• 若使用MediaBrowserServiceCompat，需保证服务端的PlaybackState与客户端通知的Action状态完全同步。

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