如何自定义MediaManager Notification Control的UI样式

系统默认拼装的MediaStyle媒体通知没有开放背景色、默认展示图的修改接口，要实现这两个定制需求，直接基于自定义RemoteViews改造通知即可，不需要改动原有MediaManager的播放控制、MediaSession联动逻辑，具体落地步骤如下：

具体实现流程 #

• 保留原有媒体通知的核心配置
  构建通知的时候必须保留Notification.MediaStyle配置，同时绑定当前的MediaSession令牌：

  // 这行配置不能丢，否则通知不会被系统识别为媒体通知
  // 会丢失锁屏控制、蓝牙外设控制、播放状态自动联动的能力
  NotificationCompat.Builder builder = new NotificationCompat.Builder(context, CHANNEL_ID)
          .setStyle(new androidx.media.app.NotificationCompat.MediaStyle()
                  .setMediaSession(mediaSession.getSessionToken())
                  .setShowActionsInCompactView(0,1,2));
  

• 编写自定义通知布局
  按照设计要求写两个布局：普通状态下的紧凑通知布局、下拉展开后的大布局，布局内按需放置歌曲名、歌手名、播放/暂停/切歌按钮、封面ImageView、根布局容器：
  • 修改背景色：直接给根布局设置自定义的背景色值即可，记得适配系统深色/浅色模式，保证文字和背景的对比度符合系统通知的可访问性要求，避免被系统强制拦截展示
  • 替换展示图片：布局内单独放封面ImageView，不要依赖系统默认从MediaSession元数据读封面的逻辑，在歌曲切换、播放状态变更的回调里，手动把要展示的图片（包括默认占位图）转成Bitmap后，通过RemoteViews.setImageViewBitmap()方法设置给对应控件
• 绑定布局交互
  自定义布局里的控制按钮，全部绑定原有业务里已经在使用的播放、暂停、切歌对应的PendingIntent，不需要额外写新的控制逻辑，点击后直接触发MediaManager的原有方法即可
• 做版本和ROM适配
  • Android 13+ 要提前申请通知权限，否则通知无法展示
  • 国内定制ROM（MIUI、ColorOS等）部分版本会强制重写媒体通知样式，给自定义布局的根控件设置android:clickable="true"、android:focusable="true"，可以大幅降低被系统篡改样式的概率
  • 自定义布局的高度不要超过系统规定的通知最大高度（普通状态最高64dp，展开状态最高256dp），否则会被系统截断

踩坑提醒 #

• 不要为了自定义样式移除MediaStyle和MediaSession的绑定配置，我之前做类似需求的时候漏过这行，上线后收到大量蓝牙耳麦无法切歌、锁屏不显示播放控制的反馈
• 不要给通知根布局设置纯透明背景，大部分系统会给透明背景的通知强制叠加系统默认的通知底色，导致自定义背景色失效
• 不要直接给RemoteViews里的ImageView设置网络图片URL，先在业务层把图片下载/解析成Bitmap再设置，避免通知栏加载图片失败出现空白块
• 车机、安卓Auto等外设端的媒体展示不受自定义的手机端通知布局影响，这些场景还是会读取MediaSession里的元数据展示，正常维护MediaSession的元数据即可，不需要额外适配

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