Android MediaStyle通知largeIcon图片像素化模糊如何解决

• 核心问题是API误用：NotificationCompat.MediaStyle 中setLargeIcon()的设计定位是展示通知来源的小尺寸标识（比如应用图标、媒体来源头像），而非全尺寸专辑封面。所有通过这个方法传入的Bitmap，都会被系统通知渲染流程强制缩放到通知大图标标准规格（通常为48dp~64dp对应设备像素值，xxhdpi设备下仅为192px左右），之后这个被压到极小尺寸的图会被拉伸填充到MediaStyle的封面展示区域，必然会出现严重的像素化、模糊问题。你在传入前打印Bitmap尺寸和原图一致没有参考价值，因为缩放逻辑是系统侧渲染通知时执行的，和你传入的原始Bitmap尺寸无关。
• 你观察到的「App内Coil加载清晰、通知内模糊」的差异，本质是两个场景的渲染逻辑完全不同：App内的AsyncImage会根据控件实际展示尺寸做采样渲染，不存在强制缩放到极小尺寸再拉伸的过程；你尝试的两种数据源构建方式（ContentResolver解析Uri、File路径读取）生成的Bitmap本身也没有问题，问题和图片解码路径无关。

• 不要通过setLargeIcon()传递专辑封面，正确的传递路径是绑定MediaStyle关联的MediaSession，通过媒体元数据传入封面Bitmap，系统会按照封面区域的实际尺寸渲染这张图，不会做强制小尺寸压缩：

// 构建媒体元数据，传入封面
val mediaMetadata = MediaMetadataCompat.Builder()
    // 注意提前把封面缩放到合适尺寸，不要直接传原图避免占用过多内存
    .putBitmap(MediaMetadataCompat.METADATA_KEY_ALBUM_ART, scaledCoverBitmap)
    // 正常填充其他媒体信息
    .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "当前播放标题")
    .putString(MediaMetadataCompat.METADATA_KEY_ARTIST, "艺术家名称")
    .build()
mediaSession.setMetadata(mediaMetadata)

• 构建MediaStyle通知时，务必把对应MediaSession的token传入样式配置，否则系统无法读取到元数据里的封面：

val notification = NotificationCompat.Builder(context, YOUR_MEDIA_CHANNEL_ID)
    .setSmallIcon(R.drawable.ic_notification_small)
    // 其他通知配置比如播放控制按钮、点击意图等正常设置
    .setStyle(
        NotificationCompat.MediaStyle()
            .setMediaSession(mediaSession.sessionToken)
            // 配置需要显示在通知紧凑视图的操作按钮下标
            .setShowActionsInCompactView(0, 1, 2)
    )
    // 不需要在这里传封面Bitmap，如有需要可以传小尺寸应用图标
    .build()

• 优化点：提前对封面Bitmap做缩放，不要直接传原图分辨率的资源。通知封面区域的最大展示尺寸一般为320dp边长，按当前设备density换算成像素做缩放即可（比如xxhdpi设备下缩放到960px边长就足够保证清晰度），过大的Bitmap不仅不会提升清晰度，反而可能触发系统通知渲染的内存限制，导致封面加载失败。
• 兼容处理：针对Android 10及以下的部分定制ROM，可以在调用setLargeIcon()时传入同一份缩放后的封面做兜底，高版本Android系统会优先读取MediaSession元数据中的专辑封面，不会出现冲突。

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