Vai al contenuto principale
@capgo/capacitor-watch API dei dispositivi Sorgente aperta

Watch Plugin Capacitor

Comunicazione Apple Watch e Wear OS con messaggistica bidirezionale tra app di telefono e orologio

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 utilizzare Watch in Capacitor

Utilizzo di @capgo/capacitor-watch

Plugin di comunicazione per Apple Watch per Capacitor. Fornisce messaggi bidirezionali 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 riuscire a farlo. Utilizza questo per comunicazioni interattive a tempo di record.
  • 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'applicazione 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 dati importanti che devono essere consegnati in modo affidabile.
  • replyToMessage - Rispondi a un messaggio dal watch che ha richiesto una risposta. Utilizza questo in risposta all'evento messageReceivedWithReply.

- Esempio di utilizzo

sendMessage

- Invia un messaggio interattivo al watch. Il watch deve essere raggiungibile per riuscire a farlo. Utilizza questo per comunicazioni interattive a tempo di record.

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

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

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'applicazione che il watch deve visualizzare.

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

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

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 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 dal watch 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

Continua con l'utilizzo di @capgo/capacitor-watch

Se stai utilizzando Utilizza @capgo/capacitor-watch per pianificare il lavoro del plugin nativo, collegalo con @capgo/capacitor-watch per i dettagli di implementazione in @capgo/capacitor-watch Avvio rapido per i dettagli di implementazione in Avvio rapido Directory dei plugin Capgo per il workflow del prodotto nella Capgo Directory dei Plugin Plugin Capacitor di Capgo For l'implementazione dettagliata in Capacitor Plugins da Capgo, e Aggiungere o Aggiornare Plugins For l'implementazione dettagliata in Aggiungere o Aggiornare Plugins.

FAQ

Domande frequenti del plugin Watch

Come posso installare il plugin Watch in un'app Capacitor?

Esegui "bun add @capgo/capacitor-watch" (o "npm install @capgo/capacitor-watch"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-watch" nella tua app code.

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

Sì. Watch è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-watch?

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

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

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-watch/ e il pacchetto è gratuito per l'installazione da npm. I bug report e le richieste di pull sono accetti.

Posso aggiornare code che utilizza Watch senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il nativo code, quindi richiede una nuova costruzione del negozio. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti Capgo live.

Carica le modifiche di Watch senza dover attendere la revisione dell'app.

Una volta che il plugin è presente nella tua store build, Capgo le aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti

Inizia con Capgo