マニフェスト ファイルを構成する

Android Auto および Android Automotive OS（AAOS）と統合するようにアプリのマニフェスト ファイルを構成します。これらのプラットフォームによる検出と接続を有効にするには、マニフェストでメディア ブラウザ サービスを宣言します。メディア コントロールなどのシステム UI コンポーネントで使用されるアトリビューション アイコンのランチャー アイコンなど、必要なアプリアイコンを指定します。

マニフェスト ファイルの詳細については、アプリ マニフェストの概要をご覧ください。

メディア ブラウザ サービスを宣言する

Android Auto と AAOS は、メディア アイテムをブラウズするために、メディア ブラウザ サービスを介してアプリに接続します。マニフェストでメディア ブラウザ サービスを宣言し、Android Auto と AAOS がサービスを検出してアプリに接続できるようにします。

次のコード スニペットは、マニフェストでメディア ブラウザ サービスを宣言する方法を示しています。このガイドの次のセクションであるメディア ブラウザ サービスを作成するでは、サービスの実装プロセスについて詳しく説明します。

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:expor>ted="<;true"
 >       intent<-filter
            action android:name="android.media.bro>wse.Media<BrowserService>"<;/
     >   /inten<t-filter
   > /service
    ...
/application

アプリアイコンを指定する

システム UI でアプリを表示するには、Android Auto と AAOS が使用するアプリアイコンを指定します。次の 2 つのアイコンが必要です。

• ランチャー アイコンを定義する
• アトリビューション アイコンを定義する

ランチャー アイコンを定義する

ランチャー アイコンは、ランチャーやアイコンのトレイなどのシステム UI で、アプリを表すアイコンです。

デフォルトでは、アプリの <application> 要素の android:icon 属性がランチャー アイコンとして使用されます。

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

別のアイコンを使用するには、メディア ブラウザ サービスの <service> 要素の android:icon 属性を設定します。

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launc>h<er"/
/a>pplication

アトリビューション アイコンを定義する

アトリビューション アイコンは、メディアカードなど、メディア コンテンツが優先される場所で使用されます。通知用の小さなアイコンを再利用することを検討してください。 このアイコンはモノクロにする必要があります。

図 1. メディアカードのアトリビューション アイコン。

次のマニフェスト宣言を使用して、アプリを表すために使用するアイコンを指定できます。

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

アプリのラベルを指定する

デフォルトでは、アプリの <application> 要素の android:label 属性の値が、車の画面に表示されるアプリの表示名として使用されます。

別の表示名を使用する場合、またはアプリに複数のメディア ブラウザ サービスがある場合は、メディア ブラウザ サービスの <service> 要素の android:label 属性を設定します。

アプリのアクセント カラーを指定する

アプリのアクセント カラーは、Android Auto と AAOS で再生コントロールやその他の UI 要素のスタイル設定に使用されます。

デフォルトでは、アクセント カラーはアプリの <application> 要素の android:theme スタイル リソースの colorAccent アイテムから取得されます。

車内エクスペリエンスで別のアクセント カラーを使用するには、colorAccent アイテムを含む別のスタイル リソースの <meta-data> 要素を含めます。

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@sty>le/THEME_<NAME"/
>    ...
/application

プラットフォーム固有の構成

このページで説明する構成に加えて、プラットフォーム固有の要件については、次のセクションをご覧ください。

• メディアアプリに Android Auto のサポートを追加する
• メディアアプリに Android Automotive OS のサポートを追加する