@capgo/capacitor-watch

Panoramica

@capgo/capacitor-watch collega la tua app Capacitor per smartphone a un'app companion per smartwatch:

• iOS: WatchConnectivity con un target watchOS e l'opzionale CapgoWatchSDK.
• Android: Data Layer per Wear OS (play-services-wearable) con un modulo Wear OS nello stesso progetto Android.
• Web: non supportato per la messaggistica watch; getInfo() e getPluginVersion() risoluzione con default sicuri; i metodi di messaggistica rifiutano; i listener si registrano ma non inviano eventi

Supporto piattaforme

Le funzionalità riportate di seguito corrispondono alle implementazioni native in CapgoWatchPlugin.swift e CapgoWatchPlugin.java.

Funzionalità	iOS (Apple Watch)	Android (Wear OS)	Web
sendMessage	Sì. Richiede una sessione attiva e isReachable.	Sì. Invia su /capgo/message ai nodi connessi. Rifiuta se non è connesso alcun nodo Wear OS.	No
updateApplicationContext	Sì. Solo l'ultimo valore tramite WatchConnectivity.	Sì. DataItem su /capgo/context con JSON in payload.	No
transferUserInfo	Sì. Trasferimento info utente in coda.	Sì. DataItem su /capgo/userinfo/{uuid} con JSON in payload.	No
replyToMessage	Sì. Dopo messageReceivedWithReply.	Sì. Invia su /capgo/reply/{callbackId} al nodo watch (TTL in attesa di 5 minuti).	No
getInfo	Sì. Pairing e reachability di WatchConnectivity.	Sì. Nodi connessi più capgo_watch capacità di rilevare l'installazione dell'app watch.	Restituisce isSupported: false
getPluginVersion	Sì	Sì	Restituisce { version: "web" }
messageReceived	Sì	Sì. In arrivo /capgo/message.	Solo registrazione; nessun evento sul web
messageReceivedWithReply	Sì	Sì. In arrivo /capgo/message/withreply.	Solo registrazione; nessun evento sul web
applicationContextReceived	Sì	Sì. In arrivo /capgo/context DataItem.	Solo registrazione; nessun evento sul web
userInfoReceived	Sì	Sì. In arrivo /capgo/userinfo/* (il telefono elimina l'elemento dopo la consegna).	Solo registrazione; nessun evento sul web
reachabilityChanged	Sì	Non emesso su Android	Solo registrazione; nessun evento sul web
activationStateChanged	Sì	Non emesso su Android	Solo registrazione; nessun evento sul web

Guide alla configurazione

• Creare un'app watchOS (Apple Watch + CapgoWatchSDK)
• Creazione di un'app Wear OS (Modulo Wear + percorsi Data Layer)

Funzionalità principali

• 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 proveniente dallo smartwatch che richiede una risposta. Da utilizzare in risposta all'evento messageReceivedWithReply.

Pubblico API

Metodo	Descrizione
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: sovrascrive quello precedente. Usalo per sincronizzare lo stato dell'app che lo smartwatch deve visualizzare.
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.
replyToMessage	Rispondi a un messaggio dello smartwatch che ha richiesto una risposta. Usalo in risposta all'evento messageReceivedWithReply.
getInfo	Ottieni informazioni sullo stato di connettività dello smartwatch.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
addListener	Ascolta i messaggi ricevuti dallo smartwatch.
addListener	Ascolta i messaggi dello smartwatch che richiedono una risposta.
addListener	Ascolta gli aggiornamenti del contesto dell'app provenienti dallo smartwatch.
addListener	Ascolta i trasferimenti di info utente dallo smartwatch.
addListener	Ascolta i cambiamenti di raggiungibilità dello smartwatch (solo iOS).
addListener	Ascolta i cambiamenti dello stato di attivazione della sessione (solo iOS).
removeAllListeners	- Rimuove tutti i listener di questo plugin.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-watch.

Continua con @capgo/capacitor-watch

Se stai usando @capgo/capacitor-watch per pianificare la migrazione e le operazioni enterprise, collegalo a Utilizzo di @capgo/capacitor-watch per la funzionalità nativa in Utilizzo di @capgo/capacitor-watch, Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative ai plugin Ionic Enterprise per il workflow del prodotto nelle alternative ai plugin Ionic Enterprise, Alternative a Capgo per il workflow di prodotto in Capgo Alternatives, e Consulenza Capgo per il workflow di prodotto in Capgo Consulting.