@capgo/capacitor-watch

Übersicht

@capgo/capacitor-watch verbindet deine Capacitor Smartphone-App mit einer Companion-Watch-App:

• iOS: WatchConnectivity mit einem watchOS-Target und optionalem CapgoWatchSDK.
• Android: Wear OS Data Layer (play-services-wearable) mit einem Wear OS-Modul im selben Android-Projekt.
• Web: nicht unterstützt für Watch-Messaging; getInfo() und getPluginVersion() werden mit sicheren Defaults aufgelöst; Messaging-Methoden rejecten; Listener registrieren sich, liefern aber nie Events

Plattformunterstützung

Die folgenden Funktionen entsprechen den nativen Implementierungen in CapgoWatchPlugin.swift und CapgoWatchPlugin.java.

Funktion	iOS (Apple Watch)	Android (Wear OS)	Web
sendMessage	Ja. Erfordert eine aktivierte Session und isReachable.	Ja. Sendet bei /capgo/message an verbundene Nodes. Wird abgelehnt, wenn kein Wear OS-Node verbunden ist.	Nein
updateApplicationContext	Ja. Nur der aktuellste Wert via WatchConnectivity.	Ja. DataItem unter /capgo/context mit JSON in payload.	Nein
transferUserInfo	Ja. User-Info-Transfer in Warteschlange.	Ja. DataItem unter /capgo/userinfo/{uuid} mit JSON in payload.	Nein
replyToMessage	Ja. Nach messageReceivedWithReply.	Ja. Sendet bei /capgo/reply/{callbackId} an den Watch-Node (5 Min. TTL).	Nein
getInfo	Ja. WatchConnectivity-Pairing und Erreichbarkeit.	Ja. Verbundene Nodes sowie capgo_watch Erkennung der Watch-App-Installation.	Rückgabewert isSupported: false
getPluginVersion	Ja	Ja	Rückgabewert { version: "web" }
messageReceived	Ja	Ja. Eingehend /capgo/message.	Nur Registrierung; keine Web-Events
messageReceivedWithReply	Ja	Ja. Eingehend /capgo/message/withreply.	Nur Registrierung; keine Web-Events
applicationContextReceived	Ja	Ja. Eingehend /capgo/context DataItem.	Nur Registrierung; keine Web-Events
userInfoReceived	Ja	Ja. Eingehend /capgo/userinfo/* (Phone löscht Item nach Zustellung).	Nur Registrierung; keine Events im Web
reachabilityChanged	Ja	Wird auf Android nicht ausgelöst	Nur Registrierung; keine Events im Web
activationStateChanged	Ja	Wird auf Android nicht ausgelöst	Nur Registrierung; keine Events im Web

Setup-Guides

• Eine watchOS-App erstellen (Apple Watch + CapgoWatchSDK)
• Erstellen einer Wear OS-App (Wear-Modul + Data-Layer-Pfade)

Kernfunktionen

• sendMessage - Sende eine interaktive Nachricht an die Watch. Die Watch muss erreichbar sein, damit das klappt. Nutze dies für zeitkritische, interaktive Kommunikation.
• updateApplicationContext - Aktualisiere den mit der Watch geteilten App-Kontext. Es wird nur der neueste Kontext behalten – er überschreibt alle vorherigen. Nutze dies, um den App-Status zu synchronisieren, den die Watch anzeigen muss.
• transferUserInfo - Übertrage Benutzerinfos an die Watch. Übertragungen werden in eine Warteschlange gestellt und in Reihenfolge zugestellt, auch wenn die Watch gerade nicht erreichbar ist. Nutze dies für wichtige Daten, die zuverlässig zugestellt werden müssen.
• replyToMessage - Antworte auf eine Nachricht der Watch, die eine Antwort angefordert hat. Nutze dies als Reaktion auf das messageReceivedWithReply-Event.

Öffentliches API

Methode	Beschreibung
sendMessage	Sende eine interaktive Nachricht an die Watch. Die Watch muss erreichbar sein, damit das klappt. Nutze dies für zeitkritische, interaktive Kommunikation.
updateApplicationContext	Aktualisiert den mit der Watch geteilten App-Kontext. Es wird nur der neueste Kontext gespeichert – damit wird jeder vorherige Kontext überschrieben. Nutze dies, um den App-Status zu synchronisieren, den die Watch anzeigen soll.
transferUserInfo	Überträgt Benutzerinfos an die Watch. Übertragungen werden in eine Warteschlange gestellt und in Reihenfolge zugestellt, auch wenn die Watch gerade nicht erreichbar ist. Nutze dies für wichtige Daten, die zuverlässig zugestellt werden müssen.
replyToMessage	Antworte auf eine Nachricht der Watch, die eine Antwort angefordert hat. Nutze dies als Reaktion auf das messageReceivedWithReply-Event.
getInfo	Informationen zum Watch-Konnektivitätsstatus abrufen.
getPluginVersion	Die native Capacitor Plugin-Version abrufen.
addListener	Auf Nachrichten von der Watch hören.
addListener	Auf Nachrichten von der Watch hören, die eine Antwort erfordern.
addListener	Auf Updates zum App-Kontext von der Watch hören.
addListener	Auf Übertragungen von Benutzerinfos von der Watch hören.
addListener	Auf Änderungen der Watch-Erreichbarkeit hören (nur iOS).
addListener	Auf Änderungen des Session-Aktivierungsstatus hören (nur iOS).
removeAllListeners	Entfernt alle Listener für dieses Plugin.

Source of Truth

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

Weiterlesen mit @capgo/capacitor-watch

Wenn du es nutzt @capgo/capacitor-watch um Migration und Enterprise-Betrieb zu planen, verbinde es mit Verwendung von @capgo/capacitor-watch für die native Funktion in „Verwendung von @capgo/capacitor-watch“, Capgo Enterprise für den Produkt-Workflow in Capgo Enterprise, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen, Capgo Alternativen für den Produkt-Workflow in Capgo Alternativen, und Capgo Beratung für den Produkt-Workflow in Capgo Consulting.