Aller au contenu

@capgo/capacitor-auto

Reliez vos applications Capacitor aux interfaces CarPlay et Android Auto pour une communication bidirectionnelle avec le véhicule

@capgo/capacitor-auto fournit une petite passerelle pour les apps nécessitant des surfaces de voiture approuvées et basées sur des templates sur iOS et Android.

Il ne duplique pas de WebView sur l'écran de la voiture. L'app mobile envoie un template voiture limité, l'hôte voiture l'affiche avec l'UI CarPlay ou Android Auto, et les sélections de lignes remontent à l'app Capacitor sous forme d'événements.

Du téléphone vers la voiture

Envoyez un template racine avec des sections, des lignes, des sous-titres et des payloads définis par l'application.

De la voiture vers le téléphone

Écoutez carAction événements lorsque le conducteur sélectionne une action sur l'écran de la voiture.

État de la connexion

Réagissez lorsqu'un hôte CarPlay ou Android Auto se connecte ou se déconnecte.

Points d'entrée natifs

Inclut un CarPlay scene delegate et Android Auto CarAppService pour que l'hôte voiture puisse lancer l'intégration.

PlateformeSupportNotes
iOSOuiNatif
AndroidOuiNatif
Le WebPartielleVoir la prise en main
  • isAvailable() renvoie le support de la plateforme et l'état actuel de la connexion.
  • setRootTemplate(options) met à jour l'écran de la voiture avec un template de liste simple.
  • sendMessage(options) envoie un message défini par l'application via le bridge natif.
  • connectionChanged signale quand l'hôte de la voiture se connecte ou se déconnecte.
  • carAction est émise lorsqu'une ligne de voiture est sélectionnée.
  • messageReceived transporte les messages du bridge définis par l'application.

iOS utilise CarPlay CPTemplateApplicationSceneDelegate et affiche un CPListTemplate.

Android utilise la bibliothèque AndroidX Car App, enregistre un CarAppService, et affiche un écran Android Auto basé sur un template.

Les deux plateformes exigent que l'app respecte les politiques d'Apple et de Google sur les apps auto. Il vous faut aussi la bonne catégorie d'app, l'entitlement, la validation en review et la configuration de plateforme adaptée à votre cas d'usage.

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-auto.

Si vous utilisez @capgo/capacitor-auto pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-auto pour la fonctionnalité native dans « Utiliser @capgo/capacitor-auto », Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.