Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-watch
Tutorial
@capgo/capacitor-watch

Watch

Apple Watch-Kommunikation mit bidirektionaler Nachrichtenübermittlung zwischen iPhone- und watchOS-Anwendungen

Richtlinie

Tutorial zur Uhr

Auf Gerät testen

Laden Sie die Capgo-App, dann scannen Sie die QR-code.

QR-Code für Plugin-Vorschau-Bildschirm code

Verwenden Sie @capgo/capacitor-watch

Apple Watch-Kommunikationsplugin für Capacitor. Bietet eine bidirektionale Nachrichtenübermittlung zwischen iPhone und Apple Watch mithilfe von WatchConnectivity.

Installieren

bun add @capgo/capacitor-watch
bunx cap sync

Was diese Plugin-Exposition enthält

  • sendMessage - Eine interaktive Nachricht an den Uhr an senden. Die Uhr muss erreichbar sein, damit dies gelingt. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.
  • updateApplicationContext - Die Anwendungs-Kontext aktualisieren, der mit der Uhr geteilt wird. Nur der aktuellste Kontext wird aufbewahrt - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungs-Zustand, der auf der Uhr angezeigt werden muss.
  • transferUserInfo - Nutzungsdaten an die Uhr übertragen. Übertragungen werden in der Reihenfolge angesammelt und geliefert, selbst wenn die Uhr derzeit nicht erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig geliefert werden müssen.
  • replyToMessage - Antworte auf eine Nachricht von der Uhr, die eine Antwort angefordert hat. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.

Beispielverwendung

sendMessage

Senden Sie eine interaktive Nachricht an die Uhr. Die Uhr muss erreichbar sein, damit dies gelingt. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.sendMessage({
  data: { action: 'refresh', timestamp: Date.now() }
});

updateApplicationContext

Aktualisieren Sie den Anwendungscontext, der mit der Uhr geteilt wird. Nur der neueste Context wird beibehalten - dies überschreibt jeden vorherigen Context. Verwenden Sie dies für das Synchronisieren von Anwendungsstatus, der auf der Uhr angezeigt werden muss.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.updateApplicationContext({
  context: { theme: 'dark', lastSync: Date.now() }
});

transferUserInfo

Nutzen Sie diese Funktion, um Nutzungsdaten an die Uhr zu übertragen. Übertragungen werden in der Reihenfolge angesammelt und geliefert, selbst wenn die Uhr derzeit nicht erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig geliefert werden müssen.

import { CapgoWatch } from '@capgo/capacitor-watch';

await CapgoWatch.transferUserInfo({
  userInfo: { recordId: '123', action: 'created' }
});

replyToMessage

Antworte auf eine Nachricht von der Uhr, die eine Antwort angefordert hat. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.

import { CapgoWatch } from '@capgo/capacitor-watch';

CapgoWatch.addListener('messageReceivedWithReply', async (event) => {
  const result = await processRequest(event.message);
  await CapgoWatch.replyToMessage({
    callbackId: event.callbackId,
    data: { result }
  });
});

Vollständige Referenz

Keep going from Using @capgo/capacitor-watch

Wenn Sie verwenden Mit @capgo/capacitor-watch um native Plugin-Arbeit zu planen, verbinden Sie es mit @capgo/capacitor-watch für die Implementierungsdetails in @capgo/capacitor-watch, Einstieg für die Implementierungsdetails in Einstieg, Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.