Utilizza @capgo/capacitor-auto
@capgo/capacitor-auto connette un'applicazione Capacitor a superfici di CarPlay e Android Auto approvate. 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.
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);
}
});
Vigila 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 interfaccia utente di vettura all'interno di template Apple approvati.
Requisiti Android
Android Auto utilizza la libreria AndroidX Car App. Il plugin include un CarAppServiceche 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
- Requisiti Android
- trasferimento di stato semplice da parte dell'app del telefono
Tenere i flussi complessi nell'interfaccia del telefono e utilizzare carAction gli eventi come trigger di intent native.
Continua da Utilizzo di @capgo/capacitor-auto
Se stai utilizzando Utilizzo di @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, Guida per l'uso per i dettagli di implementazione in Guida per l'uso, Utilizzo di @capgo/capacitor-live-activities per 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.