Saltare al contenuto principale
Indietro ai plugin
@capgo/capacitor-watch
Tutorial
da github.com/Cap-go

Watch

Comunicazione con Apple Watch con messaggistica bidirezionale tra app iPhone e watchOS

Guida

Tutorial su Watch

Utilizzo di @capgo/capacitor-watch

Plugin di comunicazione Apple Watch per Capacitor. Fornisce una comunicazione bidirezionale tra iPhone e Apple Watch utilizzando WatchConnectivity.

Installa

bun add @capgo/capacitor-watch
bunx cap sync

Cosa Questo Plugin Espone

  • sendMessage - Invia un messaggio interattivo al watch. Il watch deve essere raggiungibile per questo a riuscire. Utilizza questo per la comunicazione interattiva a tempo di tempo.
  • updateApplicationContext - Aggiorna il contesto dell'applicazione condiviso con il watch. Solo il contesto più recente viene mantenuto - questo sovrascrive qualsiasi contesto precedente. Utilizza questo per sincronizzare lo stato dell'app che il watch deve visualizzare.
  • transferUserInfo - Trasferisci informazioni dell'utente al watch. Le trasmissioni sono in coda e vengono consegnate in ordine, anche se il watch non è attualmente raggiungibile. Utilizza questo per i dati importanti che devono essere consegnati in modo affidabile.
  • replyToMessage - Rispondi a un messaggio dal orologio che ha richiesto una risposta. Utilizza questo in risposta all'evento messageReceivedWithReply.

Esempio di utilizzo

sendMessage

Inviare un messaggio interattivo all'orologio. L'orologio deve essere raggiungibile per far sì che questo funzioni. Utilizza questo per comunicazioni interattive a tempo debito.

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

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

updateApplicationContext

Aggiorna il contesto dell'applicazione condiviso con l'orologio. Solo il contesto più recente viene mantenuto - questo sovrascrive qualsiasi contesto precedente. Utilizza questo per sincronizzare lo stato dell'app che l'orologio deve visualizzare.

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

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

transferUserInfo

Trasferisci informazioni sull'utente all'orologio. Le trasmissioni sono in coda e vengono consegnate in ordine, anche se l'orologio non è attualmente raggiungibile. Utilizza questo per dati importanti che devono essere consegnati in modo affidabile.

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

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

replyToMessage

Rispondi a un messaggio dall'orologio che ha richiesto una risposta. Utilizza questo in risposta all'evento 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 }
  });
});

Riferimento completo