Saltar al contenido

@capgo/capacitor-reloj

Comunicación entre reloj Apple Watch y Wear OS para Capacitor. Mensajes bidireccionales entre iPhone y watchOS (WatchConnectivity) o teléfono Android y Wear OS (Layer de datos).

@capgo/capacitor-watch conecta la aplicación de teléfono Capacitor a una aplicación de reloj compañera:

  • iOS: WatchConnectivity con un objetivo de watchOS y opcional CapgoWatchSDK.
  • Android: Capa de datos de Wear OS (play-services-wearablecon un módulo Wear OS en el mismo proyecto de Android.
  • Web: no soportado para mensajes de reloj; getInfo() y getPluginVersion() Resuelve con valores predeterminados seguros; los métodos de mensajería rechazan; los oyentes se registran pero nunca entregan eventos.

Compatibilidad de plataforma

Compatibilidad de plataforma

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

CapacidadiOS (Apple Watch)Android (Wear OS)Web
sendMessageSí. Requiere sesión activada y isReachable.Sí. Envía en tiempo real /capgo/message A los nodos conectados. Rechaza si no hay un nodo Wear OS conectado.No
updateApplicationContextSí. Último valor solo a través de WatchConnectivity.Sí. DataItem en /capgo/context __CAPGO_KEEP_0__ payload.No
transferUserInfoSí. Transferencia de información de usuario en cola.Sí. DataItem en /capgo/userinfo/{uuid} con JSON en payload.No
replyToMessageSí. Después de messageReceivedWithReply.Sí. Envía a /capgo/reply/{callbackId} al nodo de reloj (5 minutos de TTL pendiente).No
getInfoSí. Pairing y alcance de WatchConnectivity.Sí. Nodos conectados más capgo_watch capability for watch app install detection.Devuelve isSupported: false
getPluginVersionSíSíDevuelve { version: "web" }
messageReceivedSíSí. Entrante /capgo/message.Registra solo; no eventos en web
messageReceivedWithReplySíSí. Entrante /capgo/message/withreply.Registra solo; no eventos en web
applicationContextReceivedSíSí. Entrante /capgo/context DataItem.Sólo se registra; no hay eventos en web
userInfoReceivedSíSí. Entrante /capgo/userinfo/* (el teléfono elimina el item después de la entrega).Sólo se registra; no hay eventos en web
reachabilityChangedSíNo se emite en AndroidSólo se registra; no hay eventos en web
activationStateChangedSíNo se emite en AndroidSólo se registra; no hay eventos en web
  • sendMessage - Enviar un mensaje interactivo al reloj. El reloj debe estar disponible para que esto tenga éxito. Utilice esto para comunicaciones interactivas y de tiempo sensible.
  • updateApplicationContext - Actualizar el contexto de la aplicación compartido con el reloj. Solo se mantiene el contexto más reciente - esto sobrescribe cualquier contexto anterior. Utilice esto para sincronizar el estado de la aplicación que el reloj necesita mostrar.
  • transferUserInfo - Transferir información del usuario al reloj. Las transferencias se enfilan y se entregan en orden, incluso si el reloj no está disponible actualmente. Utilice esto para datos importantes que deben entregarse de manera confiable.
  • replyToMessage - Contestar a un mensaje del reloj que solicitó una respuesta. Utilice esto en respuesta al evento messageReceivedWithReply.
MétodoDescripción
sendMessageEnviar un mensaje interactivo al reloj. El reloj debe estar disponible para que esto tenga éxito. Utilice esto para comunicaciones interactivas de tiempo sensible.
updateApplicationContextActualizar el contexto de la aplicación compartido con el reloj. Solo se mantiene el contexto más reciente - esto sobrescribe cualquier contexto anterior. Utilice esto para sincronizar el estado de la aplicación que el reloj necesita mostrar.
transferUserInfoTransferir información de usuario al reloj. Las transferencias se enfilan y se entregan en orden, incluso si el reloj no está disponible actualmente. Utilice esto para datos importantes que deben entregarse de manera confiable.
replyToMessageResponder a un mensaje del reloj que solicitó una respuesta. Utilice esto en respuesta al evento messageReceivedWithReply.
getInfoObtener información sobre el estado de conectividad del reloj.
getPluginVersionObtener la versión nativa del plugin Capacitor.
addListenerEscuchar mensajes recibidos del reloj.
addListenerEscuchar mensajes del reloj que requieren una respuesta.
addListenerEscuchar actualizaciones del contexto de la aplicación del reloj.
addListenerEscuchar transferencias de información del usuario desde el reloj.
addListenerEscuchar cambios de alcance del reloj (solo iOS).
addListenerEscuchar cambios en el estado de activación de sesión (solo iOS).
removeAllListenersEliminar todos los escuchadores para este plugin.

Esta referencia está sincronizada desde src/definitions.ts en capacitor-reloj.

Si estás utilizando @capgo/capacitor-reloj planificar la migración y las operaciones empresariales, conectándolo con Usando @capgo/capacitor-watch para la capacidad nativa en Usando @capgo/capacitor-watch Capgo Empresas para el flujo de trabajo del producto en Capgo Empresas Alternativas de Plugins Empresariales de Ionic para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives, Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, y Capgo Consultoría para el flujo de trabajo del producto en Capgo Consultoría