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 vehículo estacionado para obtener más información sobre la experiencia del usuario de estas apps en Android Auto.

android skills add android-for-cars-parked-apps

Declara la compatibilidad con Android Auto

Para declarar que tu app es compatible con Android Auto, debes incluir el siguiente elemento <category> en el filtro de intents de una actividad en el manifiesto de la 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 hagas 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 vehículos que admiten Android Auto, las apps no deben tener un formato pillarbox significativo en las pantallas horizontales, como se indica en el lineamiento de calidad de las apps para vehículos DO-2.

Por ejemplo, si una app se ejecuta en una relación de aspecto vertical con formato de pantalla panorámica en una pantalla horizontal, se rechazará durante la revisión de Play Store. Es aceptable que una app se ejecute con una relación de aspecto horizontal con un formato pillarbox mínimo en una pantalla horizontal, así como que se ejecute con una relación de aspecto horizontal con formato letterbox en una pantalla vertical.

Cómo realizar pruebas con 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:

[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
...

Cómo detectar 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 la conexión que informa la API de CarConnection. Cuando Android Auto esté conectado, será CONNECTION_TYPE_PROJECTION.
• Es el ID 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)
ParkedAuto.kt