Adicionar suporte para o Android Auto ao seu app estacionado

Em dispositivos com Android 15 ou versões mais recentes, o Android Auto permite executar apps nas categorias de apps para carros estacionados compatíveis 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 é compatível com o 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>

Em geral, 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 estar em um diferente, se preferir.

Entradas de manifesto específicas da categoria

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

Compatibilidade com tamanhos de tela comuns do Android Auto

Para oferecer a melhor experiência do usuário, recomendamos que seu app seja totalmente adaptável a diferentes tamanhos de tela. No mínimo, para garantir uma experiência de alta qualidade na variedade de carros compatíveis com o Android Auto, os apps não podem ser significativamente enquadrados em telas paisagem, conforme capturado pela diretriz de qualidade de apps para carros DO-2.

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

Testar em tamanhos de tela canônicos

Ao criar e testar seu app para o Android Auto, você pode usar as seguintes configurações da unidade principal de área de trabalho (DHU) para verificar se ele 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 seu app está sendo usado pelo Android Auto (por exemplo, para fins de análise), confira dois indicadores:

  • O estado da conexão informado pela API CarConnection. Quando o Android Auto estiver conectado, ele vai aparecer como CONNECTION_TYPE_PROJECTION.
  • O ID de exibição da tela ativa. Quando o app está sendo executado em uma tela diferente da 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 displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)