MusicService自定义通知按钮图标不显示问题求助

这种情况我之前做音乐播放器项目的时候也碰到过，大概率是这几个关键配置没做好，一步步排查就能解决：

1. 必须用符合规范的白色透明背景矢量图标 #

Android通知栏的操作按钮图标有严格规范：得是白色、透明背景的矢量图（VectorDrawable）。如果用了带彩色、不透明背景的图标，折叠状态下系统会直接隐藏图标，只有双指下拉展开通知时才显示文本。

• 把图标放在res/drawable目录，用.xml格式的矢量图，确保图标本身是纯白色，背景完全透明。
• 如果用PNG图，一定要制作成符合通知规范的白色图标，别带多余底色。

2. 检查通知渠道的配置（Android O及以上必看） #

从API 26开始，所有通知必须绑定通知渠道，渠道的设置直接影响通知显示：

• 创建渠道时，要把importance设为NotificationManager.IMPORTANCE_DEFAULT或更高等级，确保通知能正常展示操作按钮。
• 另外，确认lockscreenVisibility设置合理，避免图标被锁屏或系统安全策略隐藏。

3. 正确配置NotificationCompat.Action的图标 #

创建操作按钮时，setIcon()方法必须传入符合规范的图标资源ID，不能随便用普通图标：

// 示例代码，注意图标资源的选择
val playAction = NotificationCompat.Action.Builder(
    R.drawable.ic_play_white, // 这里必须是合规的白色矢量图标
    "PLAY",
    playPendingIntent
).build()

如果图标资源不对，或者系统识别不了，就只会显示文本而不加载图标。

4. 用MediaStyle时别忘设置setShowActionsInCompactView() #

做音乐播放通知，推荐用MediaStyle，但必须指定折叠状态下要显示的操作按钮：

val notification = NotificationCompat.Builder(this, MUSIC_CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_music_notification)
    .setContentTitle("正在播放：XXX")
    .setContentText("歌手：XXX")
    // 关键：设置折叠状态下显示哪几个操作按钮（索引对应addAction的顺序）
    .setStyle(androidx.media.app.NotificationCompat.MediaStyle()
        .setShowActionsInCompactView(0, 1, 2)) 
    .addAction(playAction)
    .addAction(pauseAction)
    .addAction(nextAction)
    .build()

要是没调用这个方法，折叠状态下系统就不会显示操作按钮的图标，只有展开才看到文本。

5. 适配深色模式与系统主题 #

有些系统在深色模式下会过滤非白色图标，导致图标隐藏。可以在res/drawable-night目录下放置适配深色模式的白色图标，确保不同主题下都能正常显示。

6. 确认PendingIntent有效 #

虽然这不会直接影响图标显示，但如果PendingIntent配置错误（比如Intent的Action没设对、Flags不正确），系统可能会禁用操作按钮的图标展示，所以要确保每个操作按钮的PendingIntent都是有效的。

按照上面的步骤排查一遍，应该就能解决图标不显示的问题了。

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