Android 11+中Media3播放通知标题与大图标修改失效排查

使用Media3中的MediaSessionService实现后台音频播放，通过setMediaNotificationProvider自定义播放通知。但在Android 11（API 30）及以上版本中，通知的标题、内容文本和大图标未按设置修改，仍显示音频文件相关的默认内容。请问这是Bug还是遗漏了某些配置？

相关代码 #

val mediaNotificationProvider = object : MediaNotification.Provider{
    override fun createNotification(
        mediaSession: MediaSession,
        customLayout: ImmutableList<CommandButton>,
        actionFactory: MediaNotification.ActionFactory,
        onNotificationChangedCallback: MediaNotification.Provider.Callback
    ): MediaNotification {
        createMediaNotification(mediaSession)
        return MediaNotification(NOTIFICATION_ID, notificationBuilder.build())
    }

    override fun handleCustomCommand(
        session: MediaSession,
        action: String,
        extras: Bundle
    ): Boolean {
        return false
    }
}

private lateinit var notificationBuilder: NotificationCompat.Builder

fun createMediaNotification(
    session: MediaSession,
) {
    notificationBuilder = NotificationCompat.Builder(context,
        NOTIFICATION_CHANNEL_ID
    )
        .setSmallIcon(R.drawable.notification)
        .setContentTitle("test title")
        .setContentText("test text")
        .setLargeIcon(BitmapFactory.decodeResource(context.resources, R.drawable.notification_large_icon))
        .setStyle(MediaStyleNotificationHelper.MediaStyle(session))

}

这不是Media3的Bug，是Android 11（API 30）及以上版本针对媒体通知的行为变化导致的——当使用关联MediaSession的MediaStyle时，系统会优先从MediaSession当前绑定的MediaItem元数据中提取标题、内容和图标，覆盖你在NotificationCompat.Builder中直接设置的值。

你可以通过以下两种方式解决：

方式一：自定义MediaItem的元数据 #

在创建播放的MediaItem时，手动设置自定义的元数据，让系统使用这些值填充通知：

// 创建自定义元数据
val customMetadata = Metadata.Builder()
    .putString(Metadata.METADATA_KEY_TITLE, "test title")
    .putString(Metadata.METADATA_KEY_DISPLAY_SUBTITLE, "test text")
    .putBitmap(Metadata.METADATA_KEY_ART, BitmapFactory.decodeResource(context.resources, R.drawable.notification_large_icon))
    .build()

// 构建MediaItem时关联自定义元数据
val mediaItem = MediaItem.Builder()
    .setUri(your_audio_uri) // 替换为你的音频URI
    .setMetadata(customMetadata)
    .build()

// 将该MediaItem设置给你的Player
player.setMediaItem(mediaItem)

方式二：修改通知构建逻辑，避免MediaStyle自动覆盖 #

如果你不想修改MediaItem的元数据，可以在构建通知时，先设置好所有自定义内容，再关联MediaStyle，同时确保MediaSession的Player没有携带会覆盖你设置的元数据：

fun createMediaNotification(session: MediaSession) {
    notificationBuilder = NotificationCompat.Builder(context, NOTIFICATION_CHANNEL_ID)
        .setSmallIcon(R.drawable.notification)
        .setContentTitle("test title")
        .setContentText("test text")
        .setLargeIcon(BitmapFactory.decodeResource(context.resources, R.drawable.notification_large_icon))
        // 先设置自定义内容，再关联MediaStyle
        .setStyle(MediaStyleNotificationHelper.MediaStyle(session)
            .setShowActionsInCompactView(0, 1) // 仅显示播放/暂停、上一曲/下一曲等控制按钮
        )
}

另外，务必检查你是否在MediaSessionService中正确注册了自定义的MediaNotificationProvider：

override fun onCreate() {
    super.onCreate()
    // 初始化Player和MediaSession
    val player = ExoPlayer.Builder(this).build()
    val mediaSession = MediaSession.Builder(this, player).build()
    setMediaSession(mediaSession)
    // 绑定自定义的MediaNotificationProvider
    setMediaNotificationProvider(mediaNotificationProvider)
}

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