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

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

android skills add android-for-cars-parked-apps

宣告 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 displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)
ParkedAuto.kt