@capgo/capacitor-watch

Panoramica

@capgo/capacitor-watch connette la tua Capacitor app per telefono a un'app per orologio di accompagnamento:

• IOS: WatchConnectivity con un target watchOS e facoltativo CapgoWatchSDK.
• Android: Wear OS Layer dei dati (play-services-wearable) con un modulo Wear OS nello stesso progetto Android.
• Web: non supportato per la messaggistica orologio; getInfo() e getPluginVersion() Risolve con impostazioni di default sicure; i metodi di messaggistica rifiutano; gli ascoltatori si registrano ma non inviano mai eventi.

Supporto della piattaforma

Le capacità sotto riportate corrispondono alle implementazioni native in CapgoWatchPlugin.swift e CapgoWatchPlugin.java.

Capacità	iOS (Apple Watch)	Android (Wear OS)	Web
sendMessage	Sì. Richiede sessione attivata e isReachable.	Sì. Invia su /capgo/message a nodi connessi. Rifiuta se non è presente un nodo Wear OS.	No
updateApplicationContext	Sì. Ultimo valore solo tramite WatchConnectivity.	Sì. DatiItem a /capgo/context con JSON in payload.	No
transferUserInfo	Sì. Trasferimento di informazioni utente in coda.	Sì. DatiItem a /capgo/userinfo/{uuid} con JSON in payload.	No
replyToMessage	Sì. Dopo messageReceivedWithReply.	Sì. Invia su /capgo/reply/{callbackId} a nodo orologio (5 minuto TTL in sospeso).	No
getInfo	Sì. Paring e raggiungibilità di WatchConnectivity.	Sì. Nodi connessi più capgo_watch capacità di rilevamento dell'installazione dell'app orologio.	Torna isSupported: false
getPluginVersion	Sì	Sì	Restituisce { version: "web" }
messageReceived	Sì	Sì. In arrivo /capgo/message.	Registra solo; nessun evento su web
messageReceivedWithReply	Sì	Sì. In arrivo /capgo/message/withreply.	Registra solo; nessun evento su web
applicationContextReceived	Sì	Sì. In arrivo /capgo/context DataItem.	Registra solo; nessun evento su web
userInfoReceived	Sì	Sì. In arrivo /capgo/userinfo/* (il telefono cancella l'elemento dopo la consegna).	Si registra solo; nessun evento su web
reachabilityChanged	Sì	Non emesso su Android	Si registra solo; nessun evento su web
activationStateChanged	Sì	Non emesso su Android	Si registra solo; nessun evento su web

Guida di configurazione

• Creazione di un'app per watchOS (Apple Watch + CapgoWatchSDK)
• Creazione di un'app per Wear OS (modulo Wear + percorsi Layer dati)

Capacità di base

• sendMessage - Invia un messaggio interattivo all'orologio. L'orologio deve essere raggiungibile per far sì che ciò abbia successo. Utilizza questo per comunicazioni interattive a tempo debito.
• updateApplicationContext - Aggiorna il contesto dell'applicazione condiviso con il watch. Solo il contesto più recente viene conservato - ciò 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 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.

Public API

Metodo	Descrizione
sendMessage	Invia un messaggio interattivo al watch. Il watch deve essere raggiungibile per riuscire a completare l'operazione. Utilizza questo per comunicazioni interattive a tempo reale.
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.
getInfo	Ottieni informazioni sullo stato di connettività del watch.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
addListener	Ascolta per i messaggi ricevuti dal watch.
addListener	Ascolta per i messaggi dal watch che richiedono una risposta.
addListener	Ascolta per gli aggiornamenti del contesto dell'applicazione dal watch.
addListener	Ascolta per le trasmissioni di informazioni dell'utente dal watch.
addListener	Ascolta i cambiamenti di raggiungibilità del watch (solo iOS).
addListener	Ascolta i cambiamenti di stato di attivazione della sessione (solo iOS).
removeAllListeners	Elimina tutti i listener per questo plugin.

Fonte di Verità

Questa referenza è sincronizzata da src/definitions.ts in capacitor-watch.

Continua da @capgo/capacitor-watch

Se stai utilizzando @capgo/capacitor-watch per pianificare la migrazione e le operazioni aziendali, connettilo con Utilizzare @capgo/capacitor-watch per la capacità nativa in Utilizzare @capgo/capacitor-watch, Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative plugin Ionic Enterprise per il workflow del prodotto in Alternative plugin Ionic Enterprise, Capgo Alternative per il workflow del prodotto in Capgo Alternative, e Capgo consulenza per il workflow del prodotto in Capgo Consulting.