Auto

Utilizza @capgo/capacitor-auto

@capgo/capacitor-auto si collega un'app Capacitor alle superfici di template approvate CarPlay e Android Auto. L'app invia una piccola lista di template alla schermata dell'auto, e la schermata dell'auto 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 macchina.

Installare e sincronizzare

npm install @capgo/capacitor-auto
npx cap sync

Invia un modello al veicolo

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 approvata da Apple per la tua categoria di app. Aggiungi la configurazione della scena CarPlay descritta in Documentazione di configurazione iOS e mantiene l'interfaccia utente del tuo veicolo all'interno di modelli approvati da Apple.

Requisiti Android

Android Auto utilizza la libreria di app per l'auto AndroidX. Il plugin include un CarAppServicee dichiara la template capacità, e si attiva per impostazione predefinita su il IOT categoria. Revisione Documentazione di configurazione per Android se il tuo app necessita di un'altra categoria di Android Auto.

Linee guida per la 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

Continua a utilizzare i flussi complessi nell'interfaccia del telefono e utilizza carAction eventi come trigger di intent nativi.

Continua a utilizzare Using @capgo/capacitor-auto

Se stai utilizzando Utilizzando @capgo/capacitor-auto per pianificare il comportamento dei media e dell'interfaccia nativa, connettilo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Avvio per i dettagli di implementazione in Avvio, Utilizzando @capgo/capacitor-live-activities per la capacità nativa in Utilizzando @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Utilizzando @capgo/capacitor-video-player per la capacità nativa in Utilizzo di @capgo/capacitor-player-video.