@capgo/capacitor-watch

Resumen

@capgo/capacitor-watch conecta tu app de Capacitor con una app para reloj:

• iOS: WatchConnectivity con un target de watchOS y opcionalmente CapgoWatchSDK.
• Android: Capa de datos de Wear OS (play-services-wearable) con un módulo de Wear OS en el mismo proyecto de Android.
• Web: no compatible para mensajería con reloj; getInfo() y getPluginVersion() resuelve con valores seguros; los métodos de mensajería fallan; los listeners se registran pero no reciben eventos

Soporte de plataformas

Las capacidades a continuación coinciden con las implementaciones nativas en CapgoWatchPlugin.swift y CapgoWatchPlugin.java.

Capacidad	iOS (Apple Watch)	Android (Wear OS)	Web
sendMessage	Sí. Requiere sesión activa y isReachable.	Sí. Reenvía al /capgo/message nodos conectados. Rechaza si no hay un nodo Wear OS conectado.	No
updateApplicationContext	Sí. Solo el último valor vía WatchConnectivity.	Sí. DataItem en /capgo/context con JSON en payload.	No
transferUserInfo	Sí. Transferencia de info de usuario en cola.	Sí. DataItem en /capgo/userinfo/{uuid} con JSON en payload.	No
replyToMessage	Sí. Después de messageReceivedWithReply.	Sí. Reenvía al /capgo/reply/{callbackId} nodo del watch (TTL pendiente de 5 minutos).	No
getInfo	Sí. Emparejamiento y reachability de WatchConnectivity.	Sí. Nodos conectados más capgo_watch capacidad para detectar la instalación de la app del watch.	Devuelve isSupported: false
getPluginVersion	Sí	Sí	Devuelve { version: "web" }
messageReceived	Sí	Sí. Entrante /capgo/message.	Solo registra; no hay eventos en web
messageReceivedWithReply	Sí	Sí. Entrante /capgo/message/withreply.	Solo registra; no hay eventos en web
applicationContextReceived	Sí	Sí. Entrante /capgo/context DataItem.	Solo registra; no hay eventos en web
userInfoReceived	Sí	Sí. Entrante /capgo/userinfo/* (el teléfono borra el elemento tras la entrega).	Solo registra; no hay eventos en web
reachabilityChanged	Sí	No se emite en Android	Solo registra; no hay eventos en web
activationStateChanged	Sí	No se emite en Android	Solo registra; no hay eventos en web

Guías de configuración

• Creación de una app para watchOS (Apple Watch + CapgoWatchSDK)
• Crear una app para Wear OS (Módulo Wear + rutas de Data Layer)

Funcionalidades principales

• sendMessage - Envía un mensaje interactivo al Apple Watch. El Apple Watch debe estar disponible para que esto funcione. Úsalo para comunicación interactiva y urgente.
• updateApplicationContext - Actualiza el contexto de la app compartido con el Apple Watch. Solo se mantiene el último contexto; esto sobrescribe cualquier contexto anterior. Úsalo para sincronizar el estado de la app que el Apple Watch necesite mostrar.
• transferUserInfo - Transfiere información del usuario al Apple Watch. Las transferencias se encolan y se entregan en orden, incluso si el Apple Watch no está disponible en ese momento. Úsalo para datos importantes que deban entregarse de forma fiable.
• replyToMessage - Responde a un mensaje del Apple Watch que solicitó una respuesta. Úsalo en respuesta al evento messageReceivedWithReply.

Público API

Método	Descripción
sendMessage	Envía un mensaje interactivo al Apple Watch. El Apple Watch debe estar disponible para que esto funcione. Úsalo para comunicación interactiva y urgente.
updateApplicationContext	Actualiza el contexto de la aplicación compartido con el reloj. Solo se mantiene el último contexto; esto sobrescribe cualquier contexto previo. Úsalo para sincronizar el estado de la app que el reloj necesita mostrar.
transferUserInfo	Transfiere información del usuario al reloj. Las transferencias se encolan y se entregan en orden, aunque el reloj no esté disponible en ese momento. Úsalo para datos importantes que deban entregarse de forma fiable.
replyToMessage	Responde a un mensaje del reloj que haya solicitado una respuesta. Úsalo en respuesta al evento messageReceivedWithReply.
getInfo	Obtén información sobre el estado de conectividad del reloj.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.
addListener	Escucha los mensajes recibidos desde el reloj.
addListener	Escucha los mensajes del reloj que requieren una respuesta.
addListener	Escucha las actualizaciones del contexto de la aplicación desde el reloj.
addListener	Escucha las transferencias de información de usuario desde el reloj.
addListener	Escucha los cambios en la disponibilidad del reloj (solo iOS).
addListener	Escucha los cambios en el estado de activación de la sesión (solo iOS).
removeAllListeners	Elimina todos los listeners de este plugin.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-watch.

Continúa desde @capgo/capacitor-watch

Si estás usando @capgo/capacitor-watch para planificar la migración y las operaciones enterprise, conéctalo con Usando @capgo/capacitor-watch para la capacidad nativa en Uso de @capgo/capacitor-watch, Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, Alternativas a Capgo para el flujo de trabajo del producto en Alternativas a Capgo, y Consultoría de Capgo para el flujo de trabajo de productos en Capgo Consulting.