駐車時向けアプリに 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 自動車向けアプリの品質に関するガイドラインに記載されているように、横向き画面でアプリが大幅にピラーボックス化しないようにする必要があります。

たとえば、アプリが横向き画面でピラーボックスを使用して縦向きのアスペクト比で実行される場合、Google 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 を通じて使用されていることを検出したい場合（分析目的など）、次の 2 つのシグナルを確認できます。

  • 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)