@capgo/capacitor-Watch
Übersicht
Section titled “Overview”@capgo/capacitor-watch Verbindet Ihr Capacitor Smartphone-App mit einer Begleit-App auf dem Uhr:
- iOS: WatchConnectivity mit einem Ziel für watchOS und optional CapgoWatchSDK.
- Android: Wear OS Datenlayer (
play-services-wearable) mit einem Wear OS-Modul im gleichen Android-Projekt. - Web: nicht unterstützt für die Uhrmacherkommunikation;
getInfo()undgetPluginVersion()mit sicheren Standardwerten auflösen; Nachrichtenmethoden ablehnen; Hörer registrieren, aber Ereignisse liefern nie
Plattformunterstützung
Unterstützte PlattformenDie unten aufgeführten Funktionen entsprechen den nativen Implementierungen in CapgoWatchPlugin.swift und CapgoWatchPlugin.java.
| Funktion | iOS (Apple Watch) | Android (Wear OS) | Web |
|---|---|---|---|
sendMessage | Ja. Erforderlich ist eine aktivierte Sitzung und isReachable. | Ja. Sendet an /capgo/message zu verbundenen Knoten. Wird abgelehnt, wenn kein Wear OS-Knoten verbunden ist. | Nein |
updateApplicationContext | Ja. Letzter Wert nur über WatchConnectivity. | Ja. Daten-Item bei /capgo/context mit JSON in payload. | Nein |
transferUserInfo | Ja. Gequeuefter Benutzer-Info-Übertrag. | Ja. Datenitem bei /capgo/userinfo/{uuid} mit JSON in payload. | Nein |
replyToMessage | Ja. Nachdem messageReceivedWithReply. | Ja. Sendet auf /capgo/reply/{callbackId} zum Watch-Node (5-minütige TTL). | Nein |
getInfo | Ja. WatchConnectivity-Pairing und Erreichbarkeit. | Ja. Verbundene Knoten plus capgo_watch Fähigkeit für Watch-App-Install-Detektion. | Rückgabe isSupported: false |
getPluginVersion | Ja | Ja | Rückgabewerte { version: "web" } |
messageReceived | Ja | Ja. Eingehend /capgo/message. | Registriert nur; keine Ereignisse im Web |
messageReceivedWithReply | Ja | Ja. Eingehend /capgo/message/withreply. | Registriert nur; keine Ereignisse im Web |
applicationContextReceived | Ja | Ja. Eingehend /capgo/context Datenitem | Registriert nur; keine Ereignisse im Web |
userInfoReceived | Ja | Ja, eingehend /capgo/userinfo/* (Nach der Lieferung wird das Item gelöscht). | Registriert nur; keine Ereignisse im Web |
reachabilityChanged | Ja | Keine Ereignisse auf Android | Registriert nur; keine Ereignisse im Web |
activationStateChanged | Ja | Keine Ereignisse auf Android | Registriert nur; keine Ereignisse im Web |
Einrichtungshinweise
Einrichtungsanleitungen- Erstellung einer watchOS-Anwendung (Apple Watch + CapgoWatchSDK)
- Erstellung einer Wear OS-Anwendung (Wear-Modul + Datenpfade für die Data Layer)
Kernfunktionen
Sektion mit dem Titel ‘Kernfunktionen’sendMessage- Senden Sie eine interaktive Nachricht an das Gerät. Das Gerät muss erreichbar sein, damit dies erfolgreich ist. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.updateApplicationContext- Aktualisieren Sie den Anwendungscontex, der mit dem Gerät geteilt wird. Nur der neueste Kontext wird beibehalten – dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der auf dem Gerät angezeigt werden muss.transferUserInfo- Übertragen Sie Benutzerinformationen an das Gerät. Übertragungen werden in der Reihenfolge abgelegt und geliefert, selbst wenn das Gerät derzeit nicht erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig geliefert werden müssen.replyToMessage- Antworten Sie auf eine Nachricht vom Gerät, die eine Antwort erfordert. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.
Öffentlich API
Sektion mit dem Titel ‘Öffentlich API’| Methode | Beschreibung |
|---|---|
sendMessage | Senden Sie eine interaktive Nachricht an das Armband. Das Armband muss für diesen Vorgang erreichbar sein. Verwenden Sie dies für zeitkritische, interaktive Kommunikation. |
updateApplicationContext | Aktualisieren Sie den Anwendungscontex, der mit dem Armband geteilt wird. Nur der neueste Kontext wird gespeichert - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der auf dem Armband angezeigt werden muss. |
transferUserInfo | Übertragen Sie Benutzerinformationen an das Armband. Übertragungen werden in der Reihenfolge abgehandelt, selbst wenn das Armband derzeit nicht erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig übertragen werden müssen. |
replyToMessage | Antworten Sie auf eine Nachricht vom Armband, die eine Antwort anfordert. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply. |
getInfo | Ermitteln Sie Informationen über den Status der Verbindung zum Armband. |
getPluginVersion | Ermitteln Sie die native Version des Capacitor-Plugins. |
addListener | Hören Sie auf Nachrichten, die vom Armband empfangen werden. |
addListener | Hören Sie auf Nachrichten vom Armband, die eine Antwort erfordern. |
addListener | Hören Sie auf Anwendungscontexterweiterungen vom Watch. |
addListener | Hören Sie auf Übertragungen von Benutzerinformationen vom Armband. |
addListener | Hören Sie auf Veränderungen der Erreichbarkeit von Watch (nur iOS). |
addListener | Hören Sie auf Veränderungen des Aktivierungsstatus der Sitzung (nur iOS). |
removeAllListeners | Entfernen Sie alle Listener für diesen Plugin. |
Quelle der Wahrheit
Abschnitt mit dem Titel „Quelle der Wahrheit“Diese Referenz wird von src/definitions.ts in capacitor-watch.
Fortsetzen von @capgo/capacitor-watch
Abschnitt mit dem Titel „Fortsetzen von @capgo/capacitor-watch“Wenn Sie Capgo verwenden @capgo/capacitor-Watch für die Planung der Migration und der Unternehmensoperationen, verbinden Sie es mit Mit @capgo/capacitor-watch für die native Fähigkeit in Mit @capgo/capacitor-watch Capgo Enterprise für den Produktworkflow in Capgo Enterprise Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen Capgo Alternativen für den Produktworkflow in Capgo Alternativen und Capgo Beratung für den Produktworkflow in Capgo Consulting.