在停車時使用的應用程式中新增對 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