Hauptinhalt überspringen
@capgo/capacitor-Uhr Geräte-APIs Offene Quelle

Watch Capacitor-Plugin

Apple Watch und Wear OS-Kommunikation mit bidirektionaler Nachrichtenaustausch zwischen Telefon- und Uhr-Apps

Installieren

bun add @capgo/capacitor-watch bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-watch
  • pnpm add @capgo/capacitor-watch
  • yarn add @capgo/capacitor-watch

Anleitung

How Capacitor Watch zu verwenden

Verwendung von @capgo/capacitor-watch

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

Installieren

bun add @capgo/capacitor-watch
bunx cap sync

Was dieses Plugin bereitstellt

  • sendMessage - Ein interaktives Nachrichten senden an den Watch. Der Watch muss für dies erfolgreich sein. Verwenden Sie dies für zeitkritische, interaktive Kommunikation.
  • updateApplicationContext - Die Anwendungskontext aktualisieren, der mit dem Watch geteilt wird. Nur der letzte Kontext wird aufbewahrt - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der vom Watch angezeigt werden muss.
  • transferUserInfo - Benutzerinformationen an den Watch übertragen. Übertragungen werden in der Reihenfolge abgeleitet, selbst wenn der Watch nicht derzeit erreichbar ist. Verwenden Sie dies für wichtige Daten, die zuverlässig übertragen werden müssen.
  • replyToMessage - Auf eine Nachricht vom Watch antworten, die eine Antwort erforderte. Verwenden Sie dies in Reaktion auf das Ereignis messageReceivedWithReply.

- Beispielverwendung

sendMessage

- Ein interaktives Nachrichten an den Watch senden. Der Watch muss für dies erfolgreich 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

- Die Anwendungskontext aktualisieren, der mit dem Watch geteilt wird. Nur der letzte Kontext wird aufbewahrt - dies überschreibt jeden vorherigen Kontext. Verwenden Sie dies für die Synchronisierung von Anwendungsstatus, der vom Watch angezeigt werden muss.

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

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

transferUserInfo

Übertrage Nutzerinformationen an das Uhren-Gerät. Übertragungen werden in einer Warteschlange angelegt und in der Reihenfolge abgehandelt, selbst wenn das Uhren-Gerät 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 vom Uhren-Gerät, die eine Antwort erfordert. Verwende 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

Fahre fort von Using @capgo/capacitor-watch

Wenn du Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-watch verwendest Verwende @capgo/capacitor-watch um native Plugin-Arbeit zu planen, verbinden Sie es mit für die Implementierungsdetails in @capgo/capacitor-watch für die Implementierungsdetails in @capgo/capacitor-Uhr Zur Einführung zur Implementierungsdetail in Zur Einführung Capgo Plugin-Verzeichnis zur Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, und Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins.

FAQ

FAQ für den Watch-Plugin

Wie installiere ich den Watch-Plugin in einer Capacitor-Anwendung?

Führen Sie "bun add @capgo/capacitor-watch" (oder "npm install @capgo/capacitor-watch") aus, dann führen Sie "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code-Datei aufnehmen. Importieren Sie sie aus "@capgo/capacitor-watch" in Ihrer code-Anwendung.

Funktioniert @capgo/capacitor-watch mit React, Vue und Angular?

Ja. Watch ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-watch?

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie die Plugin-Major-Version, die Ihrem Capacitor-Major-Version entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README listet die unterstützten Versionen auf.

Ist @capgo/capacitor-watch kostenlos und Open-Source?

Ja. Die Quelle code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-watch/ und die Pakete sind kostenlos zum Installieren von npm erhältlich. Fehlerberichte und Pull-Anfragen sind willkommen.

Kann ich code aktualisieren, das Watch verwendet, ohne eine App-Store-Bewertung?

Die Installation oder Aktualisierung des Plugins ändert die native code, daher benötigt es eine neue Store-Build. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Schiffe Watch-Änderungen ohne Warten auf die App-Überprüfung

Ändern Sie einmalig den Plugin im Store-Build, Capgo Live-Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an Benutzer in Minuten.

Beginnen Sie mit Capgo