Guida
Come usare Auto in Capacitor
Utilizzo di @capgo/capacitor-auto
@capgo/capacitor-auto Collega un'app Capacitor alle superfici template approvate di CarPlay e Android Auto. La tua app invia un piccolo template di elenco al display dell'auto, e il display dell'auto invia le azioni selezionate a JavaScript.
È progettato per flussi di lavoro sicuri per il conducente e controllati dalle policy. Non replica il tuo WebView nell'auto.
Installa e sincronizza
npm install @capgo/capacitor-auto
npx cap sync
Invia un template all'auto
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);
}
});
Monitora lo stato della 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 entitlement approvato da Apple per la categoria della tua app. Aggiungi la configurazione della scena CarPlay descritta in documenti di configurazione iOS e mantieni la UI per auto all'interno dei template approvati da Apple.
Requisiti Android
Android Auto utilizza AndroidX Car App Library. Il plugin include un CarAppService, dichiara la template capability e predefinisce la IOT categoria. Rivedi il Documentazione setup Android se la tua app richiede un'altra categoria Android Auto.
Linee guida di design
Usa la superficie dell'auto per azioni brevi e prevedibili:
- righe di stato
- comandi con un solo tocco
- conferme sicure per il conducente
- semplice passaggio di stato dall'app sul telefono
Mantieni i flussi complessi nell'UI del telefono e usa carAction gli eventi come trigger di intent nativi.
Continua da Usare @capgo/capacitor-auto
Se stai usando Utilizzo di @capgo/capacitor-auto per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.