Android Auto中MediaSession.Callback的onPrepareFromMediaId未触发问题求助

针对你遇到的问题，结合代码和Android Auto的媒体会话逻辑，整理以下排查和解决方向：

1. 调整初始播放状态的设置 #

你当前设置的初始状态是STATE_NONE，Android Auto在这种状态下可能优先触发PLAY_FROM_MEDIA_ID而非PREPARE系列方法。建议将初始状态改为STATE_STOPPED，同时确保PlaybackState的Actions包含ACTION_PREPARE：

stateBuilder = PlaybackStateCompat.Builder()
    .setActions(
        PlaybackStateCompat.ACTION_PLAY or
        PlaybackStateCompat.ACTION_PREPARE or // 补充ACTION_PREPARE
        PlaybackStateCompat.ACTION_PREPARE_FROM_MEDIA_ID or
        PlaybackStateCompat.ACTION_PLAY_FROM_MEDIA_ID or
        PlaybackStateCompat.ACTION_PREPARE_FROM_SEARCH or
        PlaybackStateCompat.ACTION_PLAY_FROM_SEARCH)
    .setState(PlaybackStateCompat.STATE_STOPPED, 0, 0.0f) // 替换STATE_NONE为STATE_STOPPED

2. 确认MediaMetadata的可播放属性 #

确保设置的MediaMetadata包含完整的可播放标记，Android Auto可能忽略缺少关键字段的媒体项：

val metadata = MediaMetadataCompat.Builder()
    .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "媒体标题")
    .putString(MediaMetadataCompat.METADATA_KEY_ARTIST, "艺术家")
    .putLong(MediaMetadataCompat.METADATA_KEY_DURATION, 300000) // 必须设置时长
    .putInt(MediaMetadataCompat.METADATA_KEY_MEDIA_TYPE, MediaMetadataCompat.MEDIA_TYPE_MUSIC)
    .build()

3. 改用PlaybackPreparer处理准备请求 #

Android Auto场景下，推荐使用PlaybackPreparer而非直接依赖MediaSession.Callback的onPrepare方法，MediaSessionConnector会自动转发客户端的准备请求：

// 实现PlaybackPreparer
class UampPlaybackPreparer : PlaybackPreparer {
    override fun getSupportedPrepareActions(): Long {
        return PlaybackStateCompat.ACTION_PREPARE_FROM_MEDIA_ID or 
               PlaybackStateCompat.ACTION_PREPARE_FROM_SEARCH
    }

    override fun prepareFromMediaId(mediaId: String, extras: Bundle?) {
        println("prepareFromMediaId $mediaId") // 这里处理准备逻辑
    }

    override fun prepareFromSearch(query: String, extras: Bundle?) {
        // 处理搜索准备逻辑
    }

    override fun prepare() {
        // 通用准备逻辑
    }
}

// 在MediaSession初始化中取消注释相关代码
mediaSessionConnector = MediaSessionConnector(mediaSession)
mediaSessionConnector.setPlaybackPreparer(UampPlaybackPreparer())

4. 检查MediaItem的可播放标记 #

在onLoadChildren返回的MediaBrowser.MediaItem中，必须将可播放项的flag设置为FLAG_PLAYABLE，如果设为FLAG_BROWSABLE，Android Auto会将其视为文件夹，点击后只会加载子项：

val mediaItem = MediaBrowser.MediaItem(
    MediaDescriptionCompat.Builder()
        .setMediaId("your_media_id")
        .setTitle("媒体标题")
        .build(),
    MediaBrowser.MediaItem.FLAG_PLAYABLE // 关键：必须标记为可播放
)

5. 验证onPlayFromMediaId是否被触发 #

部分客户端（包括Android Auto）可能直接发送PLAY_FROM_MEDIA_ID命令跳过PREPARE步骤，建议在Callback中重写该方法测试：

private val callback = object: MediaSessionCompat.Callback() {
    // ... 其他方法
    override fun onPlayFromMediaId(mediaId: String?, extras: Bundle?) {
        println("onPlayFromMediaId $mediaId")
        // 可在此合并准备+播放逻辑，准备完成后切换到PLAYING状态
    }
}

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