Guía
Tutoría sobre Auto
Usando @capgo/capacitor-auto
@capgo/capacitor-auto conecta una aplicación Capacitor a superficies de CarPlay y Android Auto aprobadas. Su aplicación envía una lista de plantillas pequeña a la pantalla del coche, y la pantalla del coche envía acciones seleccionadas de vuelta a JavaScript.
No está construido para flujos de trabajo de control de políticas y seguros para conductores. No refleja su WebView en el coche.
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' },
},
],
},
],
});
Escuchar acciones del conductor
await Auto.addListener('carAction', async (event) => {
if (event.id === 'open-main-door') {
await openGarageDoor(event.payload?.doorId);
}
});
Observar el estado de la 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
CarPlay requiere una autorización de Apple aprobada para su categoría de aplicación. Agregue la configuración de la escena de CarPlay descrita en los documentos de configuración de iOS y mantenga su interfaz de usuario del coche dentro de plantillas aprobadas por Apple.
Requisitos de Android
Android Auto utiliza la biblioteca de aplicaciones de automóvil de AndroidX. El complemento incluye un CarAppServicedeclaración de la template capacidad, y por defecto se utiliza la IOT categoría. Revisa los documentos de configuración de Android si tu aplicación necesita otra categoría de Android Auto.
Guía de diseño
Utiliza la superficie del automóvil para acciones cortas y predecibles:
- filas de estado
- comandos de un solo toque
- confirmaciones seguras para el conductor
- transferencia de estado simple desde la aplicación del teléfono
Mantenga los flujos complejos en la interfaz de usuario del teléfono y utilice carAction los eventos como disparadores de intenciones nativas.
Manténgase desde Usando @capgo/capacitor-auto
Si está utilizando Usando @capgo/capacitor-auto para planificar el comportamiento de medios y interfaz nativa, conecte @capgo/capacitor-auto para los detalles de implementación en @capgo/capacitor-auto, Inicio para los detalles de implementación en Inicio, Usando @capgo/capacitor-live-activities para la capacidad nativa en Usando @capgo/capacitor-actividades en vivo, @capgo/capacitor-actividades en vivo para el detalle de implementación en @capgo/capacitor-actividades en vivo, y Usando @capgo/capacitor-reproductor de video para la capacidad nativa en Usando @capgo/capacitor-reproductor de video.