Saltar al contenido principal
@capgo/capacitor-watch API de dispositivos Código abierto

Ver plugin Capacitor

Comunicación con Apple Watch y Wear OS con mensajería bidireccional entre las apps del móvil y del reloj

Instalar

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

Guía

Cómo usar Watch en Capacitor

Usando @capgo/capacitor-watch

Plugin de comunicación con Apple Watch para Capacitor. Permite mensajería bidireccional entre iPhone y Apple Watch mediante WatchConnectivity.

Instalar

bun add @capgo/capacitor-watch
bunx cap sync

Lo que expone este plugin

  • 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.

Ejemplo de uso

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.

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

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

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.

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

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

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.

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

await CapgoWatch.transferUserInfo({
  userInfo: { recordId: '123', action: 'created' }
});

replyToMessage

Responde a un mensaje del reloj que haya solicitado una respuesta. Úsalo en respuesta al 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 }
  });
});

Referencia completa

Continuar desde Usando @capgo/capacitor-watch

Si estás usando Usando @capgo/capacitor-watch para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-watch para los detalles de implementación en @capgo/capacitor-watch, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Watch

¿Cómo instalo el plugin Watch en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-watch" (o "npm install @capgo/capacitor-watch"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-watch" en el code de tu app.

¿Es compatible @capgo/capacitor-watch con React, Vue y Angular?

Sí. Watch es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-watch?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-watch gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-watch/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Watch sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios de Watch sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo