Добавьте поддержку 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 .

Например, если приложение работает в портретном режиме с черными полосами по бокам на альбомном экране, оно будет отклонено при проверке в Play Store. Приложение, работающее в альбомном режиме с минимальным количеством черных полос по бокам на альбомном экране, допустимо, как и приложение, работающее в альбомном режиме с черными полосами по бокам на портретном экране.

Проверка на соответствие каноническим размерам экрана.

При разработке и тестировании приложения для 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 (например, в аналитических целях), вы можете обратить внимание на два сигнала:

  • Состояние соединения, сообщаемое API CarConnection . При подключении Android Auto это будет CONNECTION_TYPE_PROJECTION .
  • Идентификатор активного дисплея. Если ваше приложение работает на дисплее, отличном от встроенного, например, при использовании Android Auto, это значение отличается от DEFAULT_DISPLAY .

Следующий фрагмент кода показывает, как объединить эти сигналы для определения использования через Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY