Auto Plugin Capacitor

Utilizza @capgo/capacitor-auto

@capgo/capacitor-auto si collega un'app Capacitor alle superfici di template approvate per CarPlay e Android Auto. L'app invia una piccola lista di template alla schermata del veicolo, e la schermata del veicolo invia azioni selezionate di ritorno a JavaScript.

È progettato per flussi di lavoro sicuri e controllati dal driver. Non riproduce la tua WebView all'interno dell'auto.

Installa e sincronizza

npm install @capgo/capacitor-auto
npx cap sync

Inviare un template alla vettura

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 conducente

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

Guarda lo stato di 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'autorizzazione Apple approvata per la tua categoria di app. Aggiungi la configurazione della scena di CarPlay descritta nei documenti di configurazione iOS e mantieni la tua UI di vettura all'interno di template Apple approvati.

Requisiti Android

Android Auto utilizza la libreria AndroidX Car App. CarAppServiceLa plugin include un template capacità, e si attiva per impostazione predefinita IOT e si attiva di default nella Documentazione di configurazione per Android Se il tuo app necessita di un'altra categoria di Android Auto.

Linee guida di progettazione

Utilizza la superficie del veicolo per azioni brevi e prevedibili:

• righe di stato
• comandi a un solo tocco
• conferme sicure per il conducente
• passaggio di stato semplice dal'app del telefono

Conserva le complesse flussi nella UI del telefono e utilizza carAction gli eventi come trigger di intent nativi.

Continua da Utilizzare @capgo/capacitor-auto

Se stai utilizzando Utilizzare @capgo/capacitor-auto per pianificare il comportamento di media e interfaccia nativa, collega @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Getting Started per i dettagli di implementazione in Avvio, Utilizzare @capgo/capacitor-live-activities per la capacità nativa in Utilizzare @capgo/capacitor-live-activities, @capgo/capacitor-attività in tempo reale per i dettagli di implementazione in @capgo/capacitor-live-attività Utilizzare @capgo/capacitor-player di video per la capacità nativa in Utilizzare @capgo/capacitor-player di video.