設定資訊清單檔案

設定應用程式的資訊清單檔案,與 Android Auto 和 Android Automotive OS (AAOS) 整合。如要讓這些平台探索及連線,請在資訊清單中宣告媒體瀏覽器服務。指定必要的應用程式圖示,包括啟動器圖示,以及供媒體控制項等系統 UI 元件使用的出處圖示。

如要進一步瞭解資訊清單檔案,請參閱「應用程式資訊清單總覽」。

宣告媒體瀏覽器服務

Android Auto 和 AAOS 都是透過媒體瀏覽器服務連結至您的應用程式,以便瀏覽媒體項目。在資訊清單中宣告媒體瀏覽器服務,讓 Android Auto 和 AAOS 探索服務並連線至您的應用程式。

下列程式碼片段說明如何在資訊清單中宣告媒體瀏覽器服務。本指南的下一節「建立媒體瀏覽器服務」將詳細說明服務的實作程序。

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

指定應用程式圖示

如要在系統 UI 中代表您的應用程式,請指定 Android Auto 和 AAOS 應使用的應用程式圖示。您必須提供以下兩種圖示:

定義啟動器圖示

啟動器圖示會在系統 UI 中代表您的應用程式,例如在啟動器和圖示匣上。

根據預設,應用程式 <application> 元素的 android:icon 屬性會做為啟動器圖示:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

如要使用其他圖示,請設定媒體瀏覽器服務 <service> 元素的 android:icon 屬性:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

定義出處圖示

出處圖示會用在媒體內容優先播放的位置,例如媒體資訊卡。建議您重複使用通知所用的小圖示。這個圖示必須是單色。

媒體資訊卡上的出處圖示

圖 1. 媒體資訊卡上的出處圖示。

您可以使用下列資訊清單宣告,指定用來代表應用程式的圖示:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

指定應用程式的標籤

根據預設,應用程式 <application> 元素的 android:label 屬性值會做為應用程式在車輛螢幕上的顯示名稱。

如要使用其他顯示名稱,或應用程式有多個媒體瀏覽器服務,請設定媒體瀏覽器服務 <service> 元素的 android:label 屬性。

指定應用程式的強調色

Android Auto 和 AAOS 會使用應用程式的強調色,設定播放控制項和其他 UI 元素的樣式。

根據預設,強調色會從應用程式 <application> 元素的 android:theme 樣式資源的 colorAccent 項目中提取。

如要為車內體驗使用不同的強調色,請加入 <meta-data> 元素,以使用包含 colorAccent 項目的不同樣式資源:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

平台專屬設定

除了本頁詳述的設定之外,請參閱下列各節,瞭解平台專屬規定: