@capgo/capacitor-auto

@capgo/capacitor-auto fornisce un piccolo bridge per le app che necessitano di interfacce auto approvate e basate su template su iOS e Android.

Non fa mirroring di una WebView sullo schermo dell'auto. L'app sul telefono invia un template auto limitato, l'host dell'auto lo renderizza con l'interfaccia CarPlay o Android Auto, e le selezioni delle righe tornano all'app Capacitor come eventi.

Dal telefono all'auto

Invia un template root con sezioni, righe, sottotitoli e payload definiti dall'applicazione.

Dall'auto al telefono

Ascolta gli carAction eventi quando il conducente seleziona un'azione sul display dell'auto.

Stato della connessione

Reagisci quando un host CarPlay o Android Auto si connette o si disconnette.

Entry point nativi

Include un CarPlay scene delegate e Android Auto CarAppService per consentire all'host dell'auto di avviare l'integrazione.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	Parziale	Vedi come iniziare

Il core API

• isAvailable() restituisce il supporto della piattaforma e lo stato attuale della connessione.
• setRootTemplate(options) aggiorna il display dell'auto con un semplice template di lista.
• sendMessage(options) invia un messaggio definito dall'app tramite il bridge nativo.
• connectionChanged segnala quando l'host dell'auto si connette o si disconnette.
• carAction viene emesso quando viene selezionata una riga dell'auto.
• messageReceived trasporta i messaggi del bridge definiti dall'app.

Modello della piattaforma

iOS utilizza CarPlay CPTemplateApplicationSceneDelegate e renderizza un CPListTemplate.

Android usa AndroidX Car App Library, registra un CarAppService, e renderizza uno schermo Android Auto predefinito.

Entrambe le piattaforme richiedono che l'app segua le policy per le app auto di Apple e Google. Sarà comunque necessario configurare correttamente la categoria dell'app, gli entitlement, l'approvazione della revisione e il setup della piattaforma per il tuo caso d'uso.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-auto.

Continua da @capgo/capacitor-auto

Se stai usando @capgo/capacitor-auto per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-auto per la funzionalità nativa in Utilizzo di @capgo/capacitor-auto, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.