Zum Hauptinhalt springen
@capgo/capacitor-watch Device-APIs Open Source

Ansehen Capacitor Plugin

Kommunikation zwischen Apple Watch und Wear OS mit bidirektionalem Messaging zwischen Smartphone- und Watch-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

Watch in Capacitor nutzen

Verwendung von @capgo/capacitor-watch

Apple Watch Kommunikations-Plugin für Capacitor. Ermöglicht bidirektionales Messaging zwischen iPhone und Apple Watch via WatchConnectivity.

Installieren

bun add @capgo/capacitor-watch
bunx cap sync

Was dieses Plugin bereitstellt

  • sendMessage - Sende eine interaktive Nachricht an die Watch. Die Watch muss erreichbar sein, damit das klappt. Nutze dies für zeitkritische, interaktive Kommunikation.
  • updateApplicationContext - Aktualisiere den mit der Watch geteilten App-Kontext. Es wird nur der neueste Kontext behalten – er überschreibt alle vorherigen. Nutze dies, um den App-Status zu synchronisieren, den die Watch anzeigen muss.
  • transferUserInfo - Übertrage Benutzerinfos an die Watch. Übertragungen werden in eine Warteschlange gestellt und in Reihenfolge zugestellt, auch wenn die Watch gerade nicht erreichbar ist. Nutze dies für wichtige Daten, die zuverlässig zugestellt werden müssen.
  • replyToMessage - Antworte auf eine Nachricht der Watch, die eine Antwort angefordert hat. Nutze dies als Reaktion auf das messageReceivedWithReply-Event.

Anwendungsbeispiel

sendMessage

Sende eine interaktive Nachricht an die Watch. Die Watch muss erreichbar sein, damit das klappt. Nutze dies für zeitkritische, interaktive Kommunikation.

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

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

updateApplicationContext

Aktualisiert den mit der Watch geteilten App-Kontext. Es wird nur der neueste Kontext gespeichert – dies überschreibt alle vorherigen Daten. Nutze dies, um den App-Status zu synchronisieren, den die Watch anzeigen soll.

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

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

transferUserInfo

Überträgt Benutzerinfos an die Watch. Die Übertragungen werden in einer Warteschlange gespeichert und in der richtigen Reihenfolge zugestellt, auch wenn die Watch gerade nicht erreichbar ist. Nutze dies für wichtige Daten, die zuverlässig ankommen müssen.

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

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

replyToMessage

Antworte auf eine Nachricht der Watch, die eine Antwort angefordert hat. Nutze dies als Reaktion auf das messageReceivedWithReply Event.

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

Weiter mit der Nutzung von @capgo/capacitor-watch

Wenn du es nutzt Verwendung von @capgo/capacitor-watch Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-watch für Details zur Implementierung in @capgo/capacitor-watch, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im 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.

FAQ

Watch Plugin FAQ

Wie installiere ich das Watch-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-watch" (oder "npm install @capgo/capacitor-watch") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-watch".

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

Ja. Watch ist ein Capacitor-Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

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

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

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

Ja. Der code-Code ist auf GitHub unter https://github.com/Cap-go/capacitor-watch/ öffentlich und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Watch nutzt, ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Watch-Änderungen ausrollen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo