Automático

Usando @capgo/capacitor-auto

@capgo/capacitor-auto conecta una aplicación Capacitor a superficies de plantillas aprobadas de CarPlay y Android Auto. 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 vuelta a JavaScript.

No se construyó 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 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 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 plugin incluye un CarAppService, declara 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
• Android requirements
• simple state handoff desde la aplicación del teléfono

Mantenga las complejas secuencias de eventos en la interfaz del teléfono y utilice carAction los eventos como disparadores de intenciones nativas.

Siga adelante desde el uso de @capgo/capacitor-auto

Si está utilizando Usando @capgo/capacitor-auto para planificar el comportamiento de medios y interfaz nativa, conecte con @capgo/capacitor-auto para el detalle de implementación en @capgo/capacitor-auto, Iniciación para el detalle de implementación en Iniciación, 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.