向停车状态下使用的应用添加 Android Auto 支持

在搭载 Android 15 或更高版本的设备上，Android Auto 支持直接在车机上运行受支持的停车应用类别中的应用。如需详细了解 Android Auto 上的停车状态下使用的应用用户体验，请参阅停车状态下使用的应用。

声明 Android Auto 支持

如需声明您的应用支持 Android Auto，您必须在应用清单中 activity 的 intent 过滤器中添加以下 <category> 元素：

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

通常，android.intent.category.CAR_LAUNCHER 类别元素可以与 android.intent.category.LAUNCHER 元素放在同一个 intent 过滤器中，但如果愿意，也可以放在不同的 intent 过滤器中。

特定于类别的清单条目

除了上述要求之外，游戏还需满足一项额外要求。 请参阅将应用标记为游戏。

支持常见的 Android Auto 屏幕尺寸

为了提供最佳用户体验，我们建议您让应用完全适应不同的屏幕尺寸。至少，为确保在支持 Android Auto 的各种汽车中提供高质量体验，应用不得在横向屏幕上出现明显的左右黑边，如 DO-2 汽车应用质量指南所述。

例如，如果应用在横屏屏幕上以纵向宽高比运行并显示左右黑边，则会在 Play 商店审核期间被拒。应用在横屏上以横向宽高比运行且仅有少量黑边是可以接受的，在竖屏上以横向宽高比运行且有黑边也是可以接受的。

针对规范屏幕尺寸进行测试

在针对 Android Auto 构建和测试应用时，您可以使用以下桌面车机 (DHU) 配置来验证应用是否满足上述要求：

小横屏

[general]
resolution = 800x480
dpi = 160
...

宽幅横向

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

纵向

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

检测 Android Auto 上的使用情况

如果您想检测应用何时通过 Android Auto 使用（例如，出于分析目的），可以查看以下两个信号：

  • CarConnection API 报告的连接状态。连接 Android Auto 后，此值将为 CONNECTION_TYPE_PROJECTION。
  • 活动显示屏的显示 ID。当您的应用在内置屏幕以外的显示屏上运行时（例如通过 Android Auto 使用时），此值不是 DEFAULT_DISPLAY。

以下代码段展示了如何结合使用这些信号来检测通过 Android Auto 的使用情况：

val displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)