Cómo agregar compatibilidad con Android Auto a tu app para usar en el vehículo estacionado

En dispositivos con Android 15 o versiones posteriores, Android Auto admite la ejecución de apps en categorías de apps compatibles para usar con el automóvil estacionado directamente en la consola central. Consulta Apps para usar con el automóvil estacionado para obtener más información sobre la experiencia del usuario con las apps para usar con el automóvil estacionado en Android Auto.

Declara la compatibilidad con Android Auto

Para declarar que tu app admite Android Auto, debes incluir el siguiente elemento <category> en el filtro de intents de una actividad en el manifiesto de tu app:

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

Por lo general, el elemento de categoría android.intent.category.CAR_LAUNCHER se puede colocar en el mismo filtro de intents que el elemento android.intent.category.LAUNCHER, pero puede estar en uno diferente si lo prefieres.

Entradas de manifiesto específicas de la categoría

Además del requisito anterior, los juegos tienen un requisito adicional. Consulta Cómo marcar tu app como juego.

Compatibilidad con tamaños de pantalla comunes de Android Auto

Para obtener la mejor experiencia del usuario, te recomendamos que tu app sea completamente adaptable a diferentes tamaños de pantalla. Como mínimo, para garantizar una experiencia de alta calidad en la variedad de automóviles que admiten Android Auto, las apps no deben tener un pillarboxing significativo en las pantallas horizontales, como se captura en el lineamiento de calidad de las apps para automóviles DO-2.

Por ejemplo, si una app se ejecuta en una relación de aspecto vertical con pillarboxing en una pantalla horizontal, se rechazará durante la revisión de Play Store. Se acepta una app que se ejecuta en una relación de aspecto horizontal con un pillarboxing mínimo en una pantalla horizontal, al igual que una app que se ejecuta en una relación de aspecto horizontal con formato letterbox en una pantalla vertical.

Realiza pruebas en tamaños de pantalla canónicos

Cuando compiles y pruebes tu app para Android Auto, puedes usar las siguientes configuraciones de la consola central de escritorio (DHU) para verificar que tu app cumpla con los requisitos anteriores:

Paisaje pequeño

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

Horizontal ancha

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

Vertical

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

Detecta el uso en Android Auto

Si deseas detectar cuándo se usa tu app a través de Android Auto (por ejemplo, para fines de análisis), puedes consultar dos indicadores:

  • Es el estado de conexión que informa la API de CarConnection. Cuando Android Auto esté conectado, será CONNECTION_TYPE_PROJECTION.
  • Es el ID de pantalla de la pantalla activa. Cuando tu app se ejecuta en una pantalla que no es integrada, como cuando se usa a través de Android Auto, este es un valor distinto de DEFAULT_DISPLAY.

En el siguiente fragmento, se muestra cómo combinar estos indicadores para detectar el uso a través de Android Auto:

val displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)