Adicionar suporte para o Android Auto ao seu app estacionado

Em dispositivos com o Android 15 ou versões mais recentes, o Android Auto oferece suporte à execução de apps em categorias de apps para carros estacionados com suporte diretamente na unidade principal. Consulte Apps estacionados para mais informações sobre a experiência do usuário com apps estacionados no Android Auto.

Declarar compatibilidade com o Android Auto

Para declarar que seu app oferece suporte ao Android Auto, inclua o seguinte elemento <category> no filtro de intent de uma atividade no manifesto do app:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

Geralmente, o elemento de categoria android.intent.category.CAR_LAUNCHER pode ser colocado no mesmo filtro de intent que o elemento android.intent.category.LAUNCHER, mas pode ser colocado em outro, se preferir.

Entradas de manifesto específicas para a categoria

Além do requisito anterior, os jogos têm um requisito extra. Consulte Marcar seu app como um jogo.

Suporte a tamanhos de tela comuns do Android Auto

Para uma melhor experiência do usuário, recomendamos que você torne seu app totalmente adaptável a diferentes tamanhos de tela. Para garantir uma experiência de alta qualidade em uma variedade de carros com suporte ao Android Auto, os apps não podem ser significativamente pillarboxed em telas no modo paisagem, conforme registrado pela diretriz de qualidade de apps para carros DO-2.

Por exemplo, se um app for executado em uma proporção de retrato com pillarboxing em uma tela no modo paisagem, ele será rejeitado durante a análise da Play Store. Um app executado em uma proporção de paisagem com pillarboxing mínimo em uma tela de paisagem é aceitável, assim como um app executado em uma proporção de paisagem com efeito letterbox em uma tela de retrato.

Testar com tamanhos de tela canônicos

Ao criar e testar seu app para o Android Auto, use as seguintes configurações da unidade principal de área de trabalho (DHU, na sigla em inglês) para verificar se o app atende aos requisitos anteriores:

Paisagem pequena

[general]
resolution = 800x480
dpi = 160
...

Paisagem ampla

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

Retrato

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

Detectar o uso no Android Auto

Se você quiser detectar quando o app está sendo usado pelo Android Auto (por exemplo, para fins de análise), analise dois indicadores:

  • O estado de conexão informado pela API CarConnection. Quando o Android Auto estiver conectado, será CONNECTION_TYPE_PROJECTION.
  • O ID da tela ativa. Quando o app está sendo executado em uma tela diferente da tela integrada, como quando usado pelo Android Auto, esse é um valor diferente de DEFAULT_DISPLAY.

O snippet a seguir mostra como combinar esses indicadores para detectar o uso pelo Android Auto:

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