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 zum Überwachen

Auf Gerät testen

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

Bildschirmansicht des Plugin-QR code

Verwendung von @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 dieses Plugin enthält

  • sendMessage - Senden Sie eine interaktive Nachricht an den Bildschirm. Der Bildschirm muss erreichbar sein, damit dies gelingt. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.
  • updateApplicationContext - Aktualisieren Sie den Anwendungscontext, der mit dem Bildschirm geteilt wird. Nur der neueste Kontext wird aufbewahrt - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der auf dem Bildschirm angezeigt werden muss.
  • transferUserInfo - Übertragen Sie Benutzerinformationen an den Bildschirm. Übertragungen werden in der Reihenfolge abgelegt und geliefert, selbst wenn der Bildschirm nicht derzeit erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig geliefert werden müssen.
  • replyToMessage - Antworte auf eine Nachricht vom Bildschirm, die eine Antwort erforderte. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.

Beispiel für die Verwendung

sendMessage

Senden Sie eine interaktive Nachricht an den Bildschirm. Der Bildschirm 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

Die Anwendungskontext aktualisieren, der mit dem Uhren geteilt wird. Nur der aktuellste Kontext wird beibehalten - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung des Anwendungsstates, der auf der Uhr angezeigt werden muss.

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

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

transferUserInfo

Benutzerinformationen an die Uhr übertragen. Übertragungen werden in der Reihenfolge abgehandelt, selbst wenn die Uhr derzeit nicht erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig übertragen werden müssen.

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

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

replyToMessage

Antwort 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

Fortsetzen von Using @capgo/capacitor-watch

Wenn Sie Using verwenden Using @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 Hinzufügen oder Aktualisieren von Plugins.