Guía
Cómo usar Auto en Capacitor
Usando @capgo/capacitor-auto
@capgo/capacitor-auto conecta una aplicación Capacitor a superficies de CarPlay y Android Auto aprobadas. Tu aplicación envía una pequeña lista de plantillas a la pantalla del coche, y la pantalla del coche envía acciones seleccionadas de regreso a JavaScript.
Es diseñado para flujos de trabajo seguros y controlados por políticas. No refleja tu WebView en el vehículo.
Instalar y sincronizar
npm install @capgo/capacitor-auto
npx cap sync
Enviar una plantilla al coche
import { Auto } from '@capgo/capacitor-auto';
await Auto.setRootTemplate({
title: 'Garage',
sections: [
{
header: 'Doors',
items: [
{
id: 'open-main-door',
title: 'Open main door',
subtitle: 'Tap to send the action to the phone app',
payload: { doorId: 'main' },
},
],
},
],
});
Escucha acciones del conductor
await Auto.addListener('carAction', async (event) => {
if (event.id === 'open-main-door') {
await openGarageDoor(event.payload?.doorId);
}
});
Observa el estado de conexión
const status = await Auto.isAvailable();
console.log(status.available, status.connected, status.platform);
await Auto.addListener('connectionChanged', (event) => {
console.log('Car connected:', event.connected, event.platform);
});
Requisitos de iOS
Requiere una autorización de Apple aprobada para tu categoría de aplicación. Agrega la configuración de la escena de CarPlay descrita en el Requisitos de Android y mantén tu interfaz de vehículo dentro de plantillas aprobadas por Apple.
Requisitos de Android
El plugin incluye una implementación de la biblioteca de aplicaciones de automóvil de AndroidX. CarAppServicedeclara la template capacidad, y por defecto se utiliza el IOT documentos de configuración de Android Documentación de configuración de Android Si su aplicación necesita otra categoría de Android Auto.
Guía de diseño
Utilice la superficie del coche para acciones cortas y predecibles:
- Filas de estado
- Comandos de un solo toque
- Confirmaciones seguras para el conductor
- Pase de estado simple desde la aplicación del teléfono
Keep complex flows in the phone UI and use carAction Eventos como disparadores de intenciones nativas.
Siga adelante desde el uso de @capgo/capacitor-auto
Si está utilizando Usando @capgo/capacitor-auto planear el comportamiento de medios y interfaz nativa, conectarlo con @capgo/capacitor-auto para el detalle de implementación en @capgo/capacitor-auto Getting Started para el detalle de implementación en Iniciación Usando @capgo/capacitor-live-actividades para la capacidad nativa en Usando @capgo/capacitor-live-actividades @capgo/capacitor-live-actividades para el detalle de implementación en @capgo/capacitor-live-actividades, y Usando @capgo/capacitor-video-player para la capacidad nativa en Usando @capgo/capacitor-video-player