Saltar al contenido principal
Volver a plugins
@capgo/capacitor-auto
Tutoriales
por github.com/Cap-go

Automático

Conecta aplicaciones Capacitor con CarPlay y Android Auto utilizando superficies de plantilla para comunicación de dos vías en el automóvil

Guía

Tutorial 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 pequeña lista de plantillas a la pantalla del coche, y la pantalla del coche envía acciones seleccionadas de regreso a JavaScript.

Está diseñado para flujos de trabajo controlados por políticas y seguros para el conductor. No refleja su WebView en el coche.

Instalar y sincronizar

npm install @capgo/capacitor-auto
npx cap sync

Enviar un modelo a la carrocería

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 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 la categoría de la aplicación aprobada por Apple para su aplicación. Agregue la configuración de la escena de CarPlay descrita en el documentación de configuración de iOS y mantenga su interfaz de usuario de coche dentro de los modelos aprobados por Apple.

Requisitos de Android

Android Auto utiliza la biblioteca de aplicaciones de coche de AndroidX. El plugin incluye un CarAppService, declara la template capacidad, y por defecto se ajusta a la IOT categoría. Revisar el Configuración de Android Si su aplicación necesita otra categoría de Android Auto.

Guía de diseño

Utilice la superficie del vehículo para acciones cortas y predecibles:

  • Filas de estado
  • Comandos de un solo toque
  • Confirmaciones seguras para el conductor
  • Paso simple de estado desde la aplicación del teléfono

Mantenga las flujos complejos en la interfaz del teléfono y utilice carAction Eventos como disparadores de intención nativa.

Siga adelante desde Usando @capgo/capacitor-auto

Si está utilizando Usando @capgo/capacitor-auto para planificar el comportamiento de medios y interfaz nativa, conectarlo con @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-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, y Usando @capgo/capacitor-video-player para la capacidad nativa en Usando @capgo/capacitor-video-player.