在停車時使用的應用程式中新增對 Android Auto 的支援

在搭載 Android 15 以上版本的裝置上，Android Auto 支援直接在車用運算主機上執行支援的車輛停妥時可用應用程式類別。如要進一步瞭解 Android Auto 的車輛停妥時應用程式使用體驗，請參閱「車輛停妥時應用程式」。

宣告 Android Auto 支援

如要宣告應用程式支援 Android Auto，您必須在應用程式資訊清單中，活動的意圖篩選器中加入下列 <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 元素相同的意圖篩選器中，但也可以放在不同的意圖篩選器中。

特定類別的資訊清單項目

除了上述規定外，遊戲還須遵守額外規定。 請參閱「將應用程式標示為遊戲」。

支援常見的 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 connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY