Utilizza @capgo/capacitor-auto

@capgo/capacitor-auto si collega un'app Capacitor a superfici di template approvate per CarPlay e Android Auto. La tua 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 il tuo WebView nella vettura.

Installare e sincronizzare

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

Ascoltare azioni del conducente

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

Visualizzare 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'entità di approvazione Apple 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 approvati da Apple.

Requisiti Android

Android Auto utilizza AndroidX Car App Library. Il plugin include un CarAppServicedeclara la template capacità, e si attiva per impostazione predefinita sul IOT categoria. Verifica i documenti di configurazione Android se il tuo app ha bisogno di un'altra categoria 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
Android Auto utilizza AndroidX Car App Library. Il plugin include un componente che dichiara la capacità, e si attiva per impostazione predefinita sul livello di categoria. Verifica i documenti di configurazione Android se il tuo app ha bisogno di un'altra categoria Android Auto.
trasferimento di stato semplice da parte dell'app del telefono

Conserva flussi complessi nell'interfaccia utente del telefono e utilizza carAction gli eventi come trigger di intenti nativi.

Conserva andando da Utilizzo di @capgo/capacitor-auto

Se stai utilizzando Utilizzo di @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, Guida di Avvio per i dettagli di implementazione in Guida di Avvio, Utilizzo di @capgo/capacitor-live-activities per la capacità nativa in Utilizzare @capgo/capacitor-live-attività @capgo/capacitor-live-attività per la 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