Automatico Plugin Capacitor

Utilizzo di @capgo/capacitor-auto

@capgo/capacitor-auto collega un'app Capacitor a interfacce approvate per CarPlay e Android Auto. La tua app invia un piccolo elenco di template al display dell'auto, che rimanda le azioni selezionate a JavaScript.

È progettato per workflow sicuri per il conducente e controllati da policy. Non riflette la tua WebView nell'auto.

Installa e sincronizza

npm install @capgo/capacitor-auto
npx cap sync

Invia un template all'auto

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' },
        },
      ],
    },
  ],
});

Ascolta le azioni del driver

await Auto.addListener('carAction', async (event) => {
  if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
  }
});

Monitora lo stato della connessione

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);
});

Requisiti iOS

CarPlay richiede un entitlement approvato da Apple per la categoria della tua app. Aggiungi la configurazione della scena CarPlay descritta nei documenti di setup iOS e mantieni la UI dell'auto entro i template approvati da Apple.

Requisiti Android

Android Auto utilizza AndroidX Car App Library. Il plugin include un CarAppService, dichiara la template capability e imposta come default la IOT categoria. Controlla la Documentazione setup Android se la tua app richiede un'altra categoria Android Auto.

Linee guida di design

Usa l'interfaccia auto per azioni brevi e prevedibili:

• righe di stato
• comandi con un solo tocco
• conferme sicure per il conducente
• passaggio fluido dello stato dall'app mobile

Mantieni i flussi complessi nell'UI del telefono e usa carAction gli eventi come trigger per gli intent nativi.

Continua da Usare @capgo/capacitor-auto

Se stai usando Utilizzo di @capgo/capacitor-auto per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.