Usando @capgo/capacitor-auto

@capgo/capacitor-auto connette 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 per il conducente, controllati da politiche. Non riflette la tua WebView nella vettura.

Installa e sincronizza

npm install @capgo/capacitor-auto
npx cap sync

Invia 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 azioni del conducente

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

Guarda 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 categoria dell'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. Il plugin include un CarAppService, dichiara il template capacità, e si attiva per impostazione predefinita sul IOT categoria. Verifica i documenti di configurazione Android se il tuo app richiede un'altra categoria di Android Auto. Linee guida per la progettazione Utilizza la superficie del veicolo per azioni brevi e predittibili:

righe di stato

comandi a un solo tocco

conferme sicure per il conducente
Android Auto utilizza la libreria AndroidX Car App. Il plugin include un
, dichiara il
trasferimento di stato semplice da parte dell'app di telefono

Mantieni flussi complessi nell'interfaccia di telefono e utilizza carAction gli eventi come trigger di intent native.

Continua dall'uso di @capgo/capacitor-auto

Se stai utilizzando Utilizza @capgo/capacitor-auto per pianificare il comportamento di media e interfaccia nativa, collegalo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Avvio per i dettagli di implementazione in Avvio, Utilizza @capgo/capacitor-live-activities For la capacità nativa in Utilizzare @capgo/capacitor-live-attività, @capgo/capacitor-live-attività Per il dettaglio di implementazione in @capgo/capacitor-live-attività, e Utilizzare @capgo/capacitor-video-player Per la capacità nativa in Utilizzare @capgo/capacitor-video-player.

Auto

Tutorial su Auto