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 が使用するアプリアイコンを指定します。次の 2 つのアイコンが必要です。
ランチャー アイコンを定義する
ランチャー アイコンは、ランチャーやアイコンのトレイなどのシステム 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 アイテムから取得されます。
車内エクスペリエンスで別のアクセント カラーを使用するには、colorAccent アイテムを含む別のスタイル リソースの <meta-data> 要素を含めます。
<application>
...
<meta-data
android:name="com.google.android.gms.car.application.theme"
android:resource="@style/THEME_NAME"/>
...
</application>
プラットフォーム固有の構成
このページで説明する構成に加えて、プラットフォーム固有の要件については、次のセクションをご覧ください。