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

Watch

Kommunikation zwischen Apple Watch und iPhone sowie zwischen watchOS-Apps und iPhone-Apps

Leitfaden

Tutorial auf Watch

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-Exposé enthält

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

Beispielanwendung

sendMessage

Senden Sie eine interaktive Nachricht an das Gerät. Das Gerät muss für diesen Vorgang erreichbar sein. 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 dem Gerät geteilt wird. Nur der neueste Context wird gespeichert - dies überschreibt jeden vorherigen Context. Verwenden Sie dies für das Synchronisieren von Anwendungsstatus, der auf dem Gerät angezeigt werden muss.

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

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

transferUserInfo

Übertragen Sie Benutzerinformationen an das Gerät. Übertragungen werden in der Reihenfolge abgefangen 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.

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

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

replyToMessage

Antworten Sie auf eine Nachricht vom Gerät, die eine Antwort anforderte. 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

Weitermachen von Using @capgo/capacitor-watch

Wenn Sie Using verwenden Verwenden Sie @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 Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.