如何为已有的Flutter音乐应用添加Android Auto支持

一、Android端基础配置 #

1. 修改AndroidManifest.xml #

在<application>标签内添加以下配置，声明车载应用元数据、媒体服务及必要的Intent过滤器：

<!-- 声明车载应用描述文件 -->
<meta-data
    android:name="com.google.android.gms.car.application"
    android:resource="@xml/automotive_app_desc" />

<!-- 配置audio_service的媒体服务，确保可被Android Auto访问 -->
<service
    android:name="com.ryanheise.audioservice.AudioService"
    android:foregroundServiceType="mediaPlayback"
    android:exported="true">
    <intent-filter>
        <action android:name="android.media.browse.MediaBrowserService" />
        <action android:name="android.intent.action.MEDIA_BUTTON" />
    </intent-filter>
</service>

<!-- 可选：添加语音搜索支持 -->
<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_PLAY_FROM_SEARCH" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

2. 创建车载应用描述文件 #

在res/xml目录下新建automotive_app_desc.xml文件，声明应用支持车载媒体功能：

<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
    <uses name="media" />
</automotiveApp>

二、关联audio_service与Android Auto #

audio_service原生支持Android Auto的媒体浏览器协议，只需确保你的音频服务子类正确实现核心回调：

class MyAudioService extends AudioService {
  @override
  Future<void> onStart(Map<String, dynamic>? params) async {
    // 初始化just_audio播放器逻辑
    // 向Android Auto同步媒体元数据
    await AudioServiceBackground.setMediaItem(MediaItem(
      id: "song_unique_id",
      title: "歌曲名称",
      artist: "艺术家",
      artUri: Uri.parse("https://example.com/cover.jpg"), // 本地资源需用content URI
    ));
    // 同步播放状态
    await AudioServiceBackground.setState(
      controls: [MediaControl.play, MediaControl.pause],
      systemActions: [MediaAction.seekTo],
      playing: true,
      processingState: AudioProcessingState.ready,
    );
  }

  // 绑定just_audio与audio_service的控制逻辑
  @override
  Future<void> onPlay() => _player.play();
  @override
  Future<void> onPause() => _player.pause();
  // 按需实现onSkipToNext、onSkipToPrevious等方法
}

三、测试与模拟器问题解决 #

1. 模拟器环境准备 #

• 使用Android 10（API 29）及以上版本的模拟器，确保已安装Android Auto应用
• 开启模拟器开发者选项中的模拟车载环境（路径：开发者选项 → Automotive → 启用模拟）
• 确保应用使用签名包（debug签名也可），Android Auto仅识别已签名应用

2. 启动测试 #

• 启动Flutter应用后，打开Android Auto应用，你的音乐应用会出现在媒体列表中
• 点击进入即可通过车载界面控制播放、查看元数据

四、关键注意事项 #

• 确保使用最新版本的audio_service和just_audio，旧版本可能存在车载适配缺陷
• 本地媒体封面需通过FileProvider生成content URI，避免Android Auto无法访问
• 若出现媒体列表不加载，检查onGetRoot和onLoadChildren方法是否正确返回媒体目录结构

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