Android Auto无法自动绑定MediaBrowserService/MediaLibraryService问题排查

1. 先把Manifest配置的细节抠对 #

• 你的MediaLibraryService必须在Manifest里加对intent-filter，还要开exported="true"——毕竟Android Auto的系统进程要访问它：

  <service
      android:name=".YourMediaLibraryService"
      android:exported="true">
      <intent-filter>
          <action android:name="android.media.browse.MediaBrowserService" />
      </intent-filter>
  </service>
  

• 权限不能少，尤其是Android 12+要加POST_NOTIFICATIONS，媒体前台服务权限也得声明：

  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA" />
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  

• 别给媒体服务乱加Car相关的meta-data，和CarAppService的配置分开。

2. 必须主动触发媒体服务的启动/绑定 #

对，你得在车载应用里主动启动或绑定MediaLibraryService——Android Auto不会自动帮你启动媒体服务。比如用户点击消息里的音频附件时，就触发这个操作：

// 示例：在车载消息界面的音频点击事件里写
val intent = Intent(context, YourMediaLibraryService::class.java)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    context.startForegroundService(intent)
} else {
    context.startService(intent)
}
// 也可以用bindService，记得要处理连接回调
// context.bindService(intent, mediaServiceConnection, Context.BIND_AUTO_CREATE)

3. 媒体服务必须立刻启动前台通知 #

Android 8+之后，媒体服务必须跑在前台，不然系统直接杀进程，onCreate根本执行不完。所以在MediaLibraryService的onCreate里，初始化完会话和播放器后，马上弹前台通知：

override fun onCreate() {
    super.onCreate()
    // 初始化ExoPlayer和MediaLibrarySession
    val player = ExoPlayer.Builder(this).build()
    val session = MediaLibrarySession.Builder(this, player, mediaLibrarySessionCallback)
        .setSessionActivity(PendingIntent.getActivity(this, 0, Intent(this, MainActivity::class.java), PendingIntent.FLAG_IMMUTABLE))
        .build()
    setSessionToken(session.sessionToken)

    // 先建个媒体通知渠道（Android 8+必需）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel("MEDIA_CHANNEL_ID", "媒体播放", NotificationManager.IMPORTANCE_LOW)
        getSystemService(NotificationManager::class.java).createNotificationChannel(channel)
    }

    // 弹出前台通知
    val notification = NotificationCompat.Builder(this, "MEDIA_CHANNEL_ID")
        .setContentTitle("正在播放音频")
        .setSmallIcon(R.drawable.ic_notification)
        .setStyle(androidx.media.app.NotificationCompat.MediaStyle()
            .setMediaSession(session.sessionToken))
        .build()

    startForeground(1, notification)
}

4. 告诉Android Auto你的应用支持媒体功能 #

在Manifest里加个meta-data，让车载系统知道你的消息App还能处理媒体：

<meta-data
    android:name="com.google.android.gms.car.application"
    android:resource="@xml/automotive_app_desc" />

然后在res/xml/automotive_app_desc.xml里同时声明消息和媒体功能：

<automotiveApp>
    <uses name="messaging" />
    <uses name="media" />
</automotiveApp>

5. 别漏了MediaLibrarySession的核心回调 #

至少要实现onGetLibraryRoot方法，不然Android Auto的媒体浏览器连不上你的服务：

private val mediaLibrarySessionCallback = object : MediaLibrarySession.Callback {
    override fun onGetLibraryRoot(
        session: MediaLibrarySession,
        browser: MediaSession.ControllerInfo,
        params: LibraryParams?
    ): LibraryResult<MediaItem> {
        // 这里可以返回你的音频附件对应的MediaItem，暂时返回空也没关系，先确保服务能启动
        return LibraryResult.success(MediaItem.EMPTY, params)
    }
}

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