Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-watch
Tutorial
von github.com/Cap-go

Watch

Apple Watch-Kommunikation mit bidirektionaler Nachrichtenaustausch zwischen iPhone- und watchOS-Anwendungen

Richtlinie

Tutorial für die Uhr

Mit @capgo/capacitor-watch verwenden

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 - Senden Sie eine interaktive Nachricht an die Uhr. Die Uhr muss für dies zu gelingen erreichbar sein. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.
  • updateApplicationContext - Aktualisieren Sie den Anwendungscontex, der mit der Uhr geteilt wird. Nur der neueste Kontext wird beibehalten - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der von der Uhr angezeigt werden muss.
  • transferUserInfo - Übertragen Sie Benutzerinformationen an die Uhr. Übertragungen werden in der Reihenfolge abgelegt und geliefert, selbst wenn die Uhr nicht derzeit 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. Verwende dies in Antwort auf das Ereignis messageReceivedWithReply.

Beispielanwendung

sendMessage

Senden Sie eine interaktive Nachricht an die Uhr. Die Uhr muss erreichbar sein, damit dies gelingt. Verwende 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 gespeichert - dies überschreibt jeden vorherigen Context. Verwende dies für das Synchronisieren von App-Zuständen, die die Uhr anzeigen muss.

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

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

transferUserInfo

Übertragen Sie Nutzerinformationen an die Uhr. Übertragungen werden in der Reihenfolge abgesendet, selbst wenn die Uhr derzeit nicht erreichbar ist. Verwende 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

Antworte auf eine Nachricht von der Uhr, die eine Antwort angefordert hat. Verwende dies in Antwort 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