将您的媒体应用扩展到 Android for Cars

将您的应用部署到搭载 Android Auto 或 Android Automotive OS 的车辆上。使用一种适合这两种情况的应用架构，让每个用户都可以享受应用带来的乐趣。

什么是 Android for Cars？

汽车专用媒体应用可让用户将自己的数字生活与汽车无缝连接。通过将适用于手机的应用扩展到汽车，您可以打造更出色的用户体验。为此，您可以与 Android Auto 或 Android Automotive OS 集成。

Android 汽车应用必须将避免驾驶员分散注意力放在第一位。您可以遵循最佳实践（例如采用语音指令和非常实用的视觉设计），尽量避免分散驾驶员的注意力。这样一来，您的媒体应用便可仅在相关时向驾驶员显示及时信息，并对常见任务采用可预测的模式。

Android Auto

Android Auto 提供针对驾驶员优化的应用体验，面向拥有安装了 Android Auto 应用的 Android 手机以及兼容的汽车或零件市场立体音响系统的用户，方便他们通过连接手机直接在汽车显示屏上使用您的应用。您可以创建 Android Auto 使用的服务，让 Android Auto 能够连接您的手机应用，以向驾驶员显示已为他们优化的界面。

注意： Android Auto 仅与搭载 Android 9（API 级别 28）或更高版本的手机兼容。

Android Automotive OS

Android Automotive OS 是一款基于 Android 的车载信息娱乐系统。车载系统是专为提升驾驶体验而优化的独立 Android 设备。借助 Android Automotive OS，用户可直接将您的应用安装到车载系统上，而不是手机上。

支持的应用类别

重要提示： 对于汽车，媒体应用和视频应用属于不同的类别，如应用类别表中所述。如需详细了解播放视频的应用，请参阅视频类别。

媒体应用可让用户在车载设备上浏览和播放音乐、电台、有声读物及其他音频内容。如需了解详情，请参阅构建车载音频播放应用。如需了解详情，请参阅构建车载媒体应用。

媒体应用使用 MediaLibraryService 和 MediaSession 构建。在 Android Automotive OS 中，您还可以使用 View 或 Compose 构建登录和设置界面（在停车状态下使用）。

视频应用可让用户在停车状态下观看流式视频。此类应用的核心用途是显示流式视频。这些应用是使用 View 或 Compose 构建的。如需了解详情，请参阅构建 Android Automotive OS 视频播放应用。如需了解详情，请参阅构建 Android Automotive OS 视频应用。

构建车载音频播放应用

本指南假定您已经拥有一款基本的媒体播放应用。如果您还没有，请先参阅创建基本媒体播放器应用。

本指南介绍了您需要执行的操作，包括指向提供具体指导的其他资源的链接。

播放组件

Media3 为播放用例提供了多个关键组件。如果您使用过之前的 Android 媒体库，则会熟悉构成这些组件的类。

下图展示了这些组件在典型应用中的组合方式。

图 1：媒体应用组件

重要提示： Media3 与之前的媒体 API 的主要区别之一是，组件之间不再需要连接器。新 MediaSession 类接受任何实现 Player 接口的类，界面也可以接受。ExoPlayer 和 MediaController 都是实现该接口的类。这有助于组件之间进行更顺畅的互动。

如需了解详情，请参阅播放组件。

实现 MediaLibraryService 和 MediaLibrarySession

MediaLibraryService 提供标准化 API，用于提供媒体库并允许访问媒体库。向媒体应用添加对 Android Auto 或 Android Automotive OS 的支持时，必须执行此操作，因为这些平台会为您的媒体库提供自己的驾驶安全界面。如需详细了解如何实现和使用 MediaLibraryService，请参阅使用 MediaLibraryService 提供内容。

对于播放控件，请使用媒体会话。MediaSession API 提供了一种与音频或视频播放器互动的方式。Jetpack Media3 库包含 MediaLibrarySession，它扩展了 MediaSession 以添加内容浏览 API。

将媒体会话连接到播放器后，应用便可向外部广告媒体播放，并接收来自 Android Auto、Android Automotive OS 或 Google 助理等外部来源的播放命令。如需了解详情，请参阅使用 MediaSession 控制和通告播放以及使用 MediaLibrarySession。

您的媒体会话至少应声明支持以下播放器命令：

• COMMAND_PLAY_PAUSE

• COMMAND_STOP

• COMMAND_SET_MEDIA_ITEM

• COMMAND_PREPARE

启用播放控件指南介绍了在汽车中自定义播放控件的方法。

当 Android Auto 或 Android Automotive OS 连接到您的应用时，它们会请求显示内容库，这会触发 onGetLibraryRoot() 回调方法。您可以快速返回根媒体项，以允许访问您的媒体库。当 Android Auto 或 Android Automotive OS 尝试浏览内容库的更深层级时，系统会调用 onGetChildren() 回调方法。

这些平台会对内容库的结构施加额外的限制。如需详细了解如何自定义内容库的显示方式，请参阅创建媒体浏览器服务指南。

声明对 Android Auto 的支持

使用以下清单条目来声明您的手机应用支持 Android Auto：

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

此清单条目引用了一个 XML 文件，用于声明应用支持的汽车功能。为了表明您有媒体应用，请将名为 automotive_app_desc.xml 的 XML 文件添加到项目的 res/xml/ 目录中。此文件应包含以下内容：

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

声明对 Android Automotive OS 的支持

您需要创建一个汽车模块，因为应用中的部分逻辑无法与汽车应用共享。Android Automotive OS 的某些组件（如清单）有特定于平台的要求。请创建一个模块，以便将这些组件的代码与项目中的其他代码（例如用于移动应用的代码）分开。

如需在项目中添加汽车模块，请按以下步骤操作：

1. 在 Android Studio 中，依次点击 File > New > New Module。
2. 选择 Automotive Module，然后点击 Next。
3. 输入 Application/Library name。这是用户在 Android Automotive OS 上看到的应用名称。
4. 输入 Module name。
5. 调整 Package name，使其与您的应用匹配。

6. 针对 Minimum SDK 选择 API 28: Android 9.0 (Pie)，然后点击 Next。

   所有支持 Android Automotive OS 的汽车搭载的都是 Android 9（API 级别 28）或更高版本，因此选择此值能将开发目标定位到所有兼容的汽车。

7. 选择 No Activity，然后点击 Finish。

在 Android Studio 中创建模块后，打开新的汽车模块中的 AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.media">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />

</manifest>

application 元素中包含一些标准应用信息，但还有一个 uses-feature 元素，用于声明对 Android Automotive OS 的支持。请注意，清单中未声明任何 activity。

如果您实现了设置或登录 activity，请在此处添加。这些 activity 由系统使用显式 intent 触发，并且只有它们是您要在您的 Android Automotive OS 应用的清单中声明的 activity。

添加任何设置或登录 activity 后，通过在 application 元素中设置 android:appCategory="audio" 属性并添加以下 uses-feature 元素，完成您的清单文件：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.media">

    <application
        android:allowBackup="true"
        android:appCategory="audio"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />

    <uses-feature
        android:name="android.hardware.wifi"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.portrait"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.landscape"
        android:required="false" />

</manifest>

通过将这些功能显式设置为 required="false" 功能，可确保应用不会与 Automotive OS 设备中的可用硬件功能发生冲突。

使用以下清单条目来声明应用支持 Android Automotive OS：

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

此清单条目引用了一个 XML 文件，用于声明应用支持的汽车功能。

为了表明您有媒体应用，请将名为 automotive_app_desc.xml 的 XML 文件添加到项目的 res/xml/ 目录中。请在此文件中包含以下内容：

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

注意： 请勿在您的 Android Automotive OS 应用中包含对 Android Auto 所需的 com.google.android.gms.car.application 属性的任何引用。

intent 过滤器

Android Automotive OS 使用显式 intent 触发媒体应用中的 activity。请勿在清单文件中包含具有 CATEGORY_LAUNCHER 或 ACTION_MAIN intent 过滤器的任何 activity。

以下示例中的 activity 通常会将目标设备定为手机或其他移动设备。在构建手机应用的模块中声明这些 activity，而不是在构建 Android Automotive OS 应用的模块中声明。

<activity android:name=".MyActivity">
<intent-filter>
<!-- You can't use either of these intents for Android Automotive OS -->
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
<!--
In their place, you can include other intent filters for any activities
that your app needs for Android Automotive OS, such as settings or
sign-in activities.
-->
</intent-filter>
</activity>

后续步骤

现在，您已经拥有适用于 Android Auto 和 Android Automotive OS 的应用，不妨采取进一步措施来优化应用，以便在驾车时更安全地使用。如需了解更多有助于确保安全便捷的用户体验的建议，请参阅语音指令、分散注意力防范措施和错误处理的技术指南。

构建 Android Automotive OS 视频播放应用

由于视频应用在汽车中与媒体应用分门别类，因此您需要了解视频应用的一些具体要求，如为 Android Automotive OS 构建停车状态下使用的应用和为 Android Automotive OS 构建视频应用中所述。您需要按照以下说明操作。

设计准则：请参阅调整视频应用，了解针对视频应用的用户体验准则。

重要提示：Google 非常重视防止驾驶员分心。应用必须满足特定条件，才能在 Google Play 中的 Android Automotive OS 版块上架。遵循这些要求后，您就能更高效地构建和测试应用。如需了解详情，请参阅 Android 车载应用质量。

将应用标记为视频应用

为了指明您的应用支持视频，请将名为 automotive_app_desc.xml 的 XML 文件添加到项目的 res/xml/ 目录中。在此文件中，请添加以下内容：

<automotiveApp>
    <uses name="video"/>
</automotiveApp>

注意： 您可能会在 Android Studio 中看到一条内容为“Expecting one of media, notification, sms, or template for the name attribute in uses tag”的 lint 错误。只需在 uses 元素中添加 tools:ignore="InvalidUsesTagAttribute"，便可放心地忽略此错误。

然后，在清单的 application 元素中，添加以下引用此 XML 文件的 meta-data 元素：

<meta-data android:name="com.android.automotive"
    android:resource="@xml/automotive_app_desc"/>