Zum Inhalt springen

@capgo/capacitor-auto

Verbinde Capacitor-Apps über CarPlay- und Android Auto-Template-Oberflächen für bidirektionale Kommunikation mit dem Auto

@capgo/capacitor-auto bietet eine kleine Bridge für Apps, die genehmigte, templatebasierte Car Surfaces auf iOS und Android benötigen.

Es spiegelt keine WebView auf den Car-Bildschirm. Die Phone-App sendet ein begrenztes Car-Template, der Car-Host rendert es mit CarPlay- oder Android-Auto-UI, und Row-Auswahlen kommen als Events zur Capacitor-App zurück.

Phone zu Car

Pushen eines Root-Templates mit Sektionen, Rows, Subtitles und anwendungsspezifischen Payloads.

Car zu Phone

Lauscht auf carAction Events, wenn der Fahrer eine Aktion auf dem Car-Display auswählt.

Verbindungsstatus

Reagieren, wenn ein CarPlay- oder Android-Auto-Host verbindet oder die Verbindung trennt.

Native Entry Points

Liefert einen CarPlay-Scene-Delegate und Android Auto CarAppService damit der Car-Host die Integration starten kann.

PlattformSupportNotizen
iOSJaNative
AndroidJaNative
WebTeilweiseErste Schritte ansehen
  • isAvailable() gibt die Plattformunterstützung und den aktuellen Verbindungsstatus zurück.
  • setRootTemplate(options) aktualisiert die Fahrzeuganzeige mit einer einfachen Listenvorlage.
  • sendMessage(options) sendet eine anwendungsdefinierte Nachricht über die native Bridge.
  • connectionChanged meldet, wenn sich der Fahrzeug-Host verbindet oder trennt.
  • carAction wird ausgelöst, wenn eine Fahrzeugzeile ausgewählt wird.
  • messageReceived überträgt anwendungsdefinierte Bridge-Nachrichten.

iOS verwendet CarPlay CPTemplateApplicationSceneDelegate und rendert eine CPListTemplate.

Android verwendet die AndroidX Car App Library, registriert eine CarAppService, und rendert einen Android Auto-Screen mit Template.

Beide Plattformen erfordern, dass die App die Car-App-Richtlinien von Apple und Google einhält. Du brauchst weiterhin die richtige App-Kategorie, Berechtigung, Freigabe durch die Prüfung und die plattformspezifische Einrichtung für deinen Anwendungsfall.

Single Source of Truth

Abschnitt: „Source of truth“

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-auto.

Wenn du es nutzt @capgo/capacitor-auto Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/capacitor-auto für die native Funktion bei der Nutzung von @capgo/capacitor-auto, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.