Utilizza @capgo/capacitor-auto
@capgo/capacitor-auto connette un'applicazione Capacitor a superfici di CarPlay e Android Auto approvate. L'applicazione invia una piccola lista di template alla schermata del veicolo, e la schermata del veicolo invia azioni selezionate di ritorno a JavaScript.
E' costruito 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
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 nel Istruzioni di configurazione per iOS E conserva l'interfaccia utente del tuo veicolo all'interno di modelli approvati da Apple.
Istruzioni di configurazione per Android
Android Auto utilizza la libreria di applicazioni per auto AndroidX. Il plugin include un CarAppServicedeclara la template capacità, e si attiva per impostazione predefinita nella IOT categoria. Consulta le Istruzioni di configurazione per Android se il tuo app ha bisogno 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 di un solo tocco
- conferme sicure del driver
- passaggio di stato semplice dall'app di telefono
Mantieni i flussi complessi nell'interfaccia di telefono e utilizza carAction gli eventi come trigger di intent nativi.
Continua dall'uso di @capgo/capacitor-auto
Se stai utilizzando Utilizza @capgo/capacitor-auto per pianificare il comportamento di media e interfaccia nativa, connettilo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto Iniziare per i dettagli di implementazione in Getting Started, Utilizzando @capgo/capacitor-live-attività per la capacità nativa in Utilizzando @capgo/capacitor-live-attività, @capgo/capacitor-live-attività per i dettagli di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-player-video per la capacità nativa in Utilizzando @capgo/capacitor-player-video.