Zum Inhalt springen

@capgo/capacitor-auto

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

@capgo/capacitor-auto bietet eine kleine Bridge für Apps, die genehmigte, Template-basierte Car-Oberflächen auf iOS und Android benötigen.

Es spiegelt keine WebView auf den Car-Screen. Die App sendet ein begrenztes Car-Template, das Car-Host rendert es mit CarPlay- oder Android Auto-UI, und Zeilenauswahlen werden als Events an die Capacitor App zurückgegeben.

Phone zu Car

Push eines Root-Templates mit Sektionen, Zeilen, Untertiteln und anwendungsspezifischen Payloads.

Car zu Phone

Auf ... hören carAction Events, wenn der Fahrer eine Aktion auf dem Car-Display auswählt.

Verbindungsstatus

Reagiere, wenn ein CarPlay- oder Android Auto-Host eine Verbindung aufbaut oder trennt.

Native Entry Points

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

PlattformSupportHinweise
iOSJaNativ
AndroidJaNativ
WebTeilweiseErste Schritte ansehen
  • isAvailable() gibt die Plattformunterstützung und den aktuellen Verbindungsstatus zurück.
  • setRootTemplate(options) aktualisiert das Fahrzeugdisplay mit einem einfachen Listen-Template.
  • sendMessage(options) sendet eine anwendungsspezifische Nachricht über die Native Bridge.
  • connectionChanged meldet, wenn der Car Host eine Verbindung aufbaut oder trennt.
  • carAction wird ausgelöst, wenn eine Fahrzeugzeile ausgewählt wird.
  • messageReceived überträgt anwendungsspezifische Bridge-Nachrichten.

iOS nutzt CarPlay CPTemplateApplicationSceneDelegate und rendert einen CPListTemplate.

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

Beide Plattformen erfordern, dass die App den Car-App-Richtlinien von Apple und Google entspricht. Du benötigst weiterhin die passende App-Kategorie, Entitlements, die Review-Freigabe sowie das richtige Plattform-Setup für deinen Anwendungsfall.

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

Wenn Sie ... verwenden @capgo/capacitor-auto um die Arbeit an Native Plugins zu planen, verbinde es mit @capgo/capacitor-auto verwenden für die native Funktion bei der Verwendung von @capgo/capacitor-auto, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails unter Plugins hinzufügen oder aktualisieren, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei Ionic Enterprise Plugin-Alternativen.