Usando @capgo/capacitor-auto
@capgo/capacitor-auto connette un'applicazione Capacitor alle superfici di template approvate di CarPlay e Android Auto. L'applicazione 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 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 nei documenti di configurazione iOS e mantieni la tua interfaccia utente della vettura all'interno dei template approvati da Apple.
Requisiti Android
Android Auto utilizza la libreria AndroidX Car App. Il plugin include un CarAppService, dichiara il template capacità, e si attiva su il IOT categoria. Verifica i documenti di configurazione Android se il tuo app richiede un'altra categoria di 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 la libreria AndroidX Car App. Il plugin include un __CAPGO_KEEP_0__ , dichiara il __CAPGO_KEEP_1__ , e si attiva su il __CAPGO_KEEP_2__ categoria. Verifica i __CAPGO_KEEP_3__ documenti di configurazione Android se il tuo app richiede un'altra categoria di Android Auto.
- trasferimento di stato semplice dalla app del telefono
Mantieni le flussi complessi nella UI del 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, 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 il nativo capgo/capacitor-live-attività, @capgo/capacitor-live-attività Per il dettaglio di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-video-player Per il nativo capgo/capacitor-video-player.