Zum Inhalt springen

@capgo/capacitor-Watch

Apple Watch und Wear OS-Kommunikation für Capacitor. Zweidirektionsmessaging zwischen iPhone und watchOS (WatchConnectivity) oder Android-Smartphone und Wear OS (Data Layer).

@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() und getPluginVersion() mit sicheren Standardwerten auflösen; Nachrichtenmethoden ablehnen; Hörer registrieren, aber Ereignisse liefern nie

Plattformunterstützung

Unterstützte Plattformen

Die unten aufgeführten Funktionen entsprechen den nativen Implementierungen in CapgoWatchPlugin.swift und CapgoWatchPlugin.java.

FunktioniOS (Apple Watch)Android (Wear OS)Web
sendMessageJa. 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
updateApplicationContextJa. Letzter Wert nur über WatchConnectivity.Ja. Daten-Item bei /capgo/context mit JSON in payload.Nein
transferUserInfoJa. Gequeuefter Benutzer-Info-Übertrag.Ja. Datenitem bei /capgo/userinfo/{uuid} mit JSON in payload.Nein
replyToMessageJa. Nachdem messageReceivedWithReply.Ja. Sendet auf /capgo/reply/{callbackId} zum Watch-Node (5-minütige TTL).Nein
getInfoJa. WatchConnectivity-Pairing und Erreichbarkeit.Ja. Verbundene Knoten plus capgo_watch Fähigkeit für Watch-App-Install-Detektion.Rückgabe isSupported: false
getPluginVersionJaJaRückgabewerte { version: "web" }
messageReceivedJaJa. Eingehend /capgo/message.Registriert nur; keine Ereignisse im Web
messageReceivedWithReplyJaJa. Eingehend /capgo/message/withreply.Registriert nur; keine Ereignisse im Web
applicationContextReceivedJaJa. Eingehend /capgo/context DatenitemRegistriert nur; keine Ereignisse im Web
userInfoReceivedJaJa, eingehend /capgo/userinfo/* (Nach der Lieferung wird das Item gelöscht).Registriert nur; keine Ereignisse im Web
reachabilityChangedJaKeine Ereignisse auf AndroidRegistriert nur; keine Ereignisse im Web
activationStateChangedJaKeine Ereignisse auf AndroidRegistriert nur; keine Ereignisse im Web

Einrichtungshinweise

Einrichtungsanleitungen
  • 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.
MethodeBeschreibung
sendMessageSenden Sie eine interaktive Nachricht an das Armband. Das Armband muss für diesen Vorgang erreichbar sein. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.
updateApplicationContextAktualisieren 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.
replyToMessageAntworten Sie auf eine Nachricht vom Armband, die eine Antwort anfordert. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.
getInfoErmitteln Sie Informationen über den Status der Verbindung zum Armband.
getPluginVersionErmitteln Sie die native Version des Capacitor-Plugins.
addListenerHören Sie auf Nachrichten, die vom Armband empfangen werden.
addListenerHören Sie auf Nachrichten vom Armband, die eine Antwort erfordern.
addListenerHören Sie auf Anwendungscontexterweiterungen vom Watch.
addListenerHören Sie auf Übertragungen von Benutzerinformationen vom Armband.
addListenerHören Sie auf Veränderungen der Erreichbarkeit von Watch (nur iOS).
addListenerHören Sie auf Veränderungen des Aktivierungsstatus der Sitzung (nur iOS).
removeAllListenersEntfernen Sie alle Listener für diesen Plugin.

Diese Referenz wird von src/definitions.ts in 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.