Salta al contenuto principale
@capgo/capacitor-watch API dei dispositivi Open source

Guarda Plugin Capacitor

Comunicazione tra Apple Watch e Wear OS con messaggi bidirezionali tra app telefono e watch

Installa

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

Guida

Come usare Watch in Capacitor

Utilizzo di @capgo/capacitor-watch

Plugin di comunicazione per Apple Watch per Capacitor. Offre messaggistica bidirezionale tra iPhone e Apple Watch tramite WatchConnectivity.

Installa

bun add @capgo/capacitor-watch
bunx cap sync

Cosa espone questo plugin

  • sendMessage - Invia un messaggio interattivo allo smartwatch. Lo smartwatch deve essere raggiungibile per completare l'operazione. Usalo per comunicazioni interattive e urgenti.
  • updateApplicationContext - Aggiorna il contesto dell'app condiviso con lo smartwatch. Viene mantenuto solo l'ultimo contesto, sovrascrivendo i precedenti. Usalo per sincronizzare lo stato dell'app che lo smartwatch deve visualizzare.
  • transferUserInfo - Trasferisci informazioni utente allo smartwatch. I trasferimenti vengono messi in coda e consegnati in ordine, anche se lo smartwatch non è raggiungibile. Usalo per dati critici che devono essere consegnati in modo affidabile.
  • replyToMessage - Rispondi a un messaggio dello smartwatch che richiede una risposta. Da usare in risposta all'evento messageReceivedWithReply.

Esempio d'uso

sendMessage

Invia un messaggio interattivo allo smartwatch. Lo smartwatch deve essere raggiungibile per completare l'operazione. Usalo per comunicazioni interattive e urgenti.

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

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

updateApplicationContext

Aggiorna il contesto dell'app condiviso con lo smartwatch. Viene mantenuto solo l'ultimo contesto: sovrascrive quello precedente. Usalo per sincronizzare lo stato dell'app che lo smartwatch deve visualizzare.

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

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

transferUserInfo

Trasferisci le info utente allo smartwatch. I trasferimenti vengono messi in coda e consegnati in ordine, anche se lo smartwatch non è raggiungibile. Usalo per i dati importanti che devono arrivare in modo affidabile.

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

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

replyToMessage

Rispondi a un messaggio dello smartwatch che ha richiesto una risposta. Usalo 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

Continua da Usare @capgo/capacitor-watch

Se stai usando Utilizzo di @capgo/capacitor-watch per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-watch per i dettagli di implementazione in @capgo/capacitor-watch, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin Watch

Come installo il plugin Watch in un'app Capacitor?

Esegui "bun add @capgo/capacitor-watch" (o "npm install @capgo/capacitor-watch"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android includano la parte nativa di code. Importalo da "@capgo/capacitor-watch" nel tuo code.

@capgo/capacitor-watch funziona con React, Vue e Angular?

Sì. Watch è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-watch?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-watch è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-watch/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Watch senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci le modifiche di Watch senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo