Saltar al contenido principal
@capgo/capacitor-reloj Dispositivos de API Fuente abierta

Reloj plugin de Capacitor

Comunicación con Apple Watch con mensajería bidireccional entre aplicaciones de iPhone y watchOS

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

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Vista previa del plugin de reloj QR code

Usando @capgo/capacitor-reloj

Plugin de comunicación para Apple Watch para Capacitor. Proporciona un intercambio bidireccional de mensajes entre iPhone y Apple Watch mediante WatchConnectivity.

Instalar

bun add @capgo/capacitor-watch
bunx cap sync

¿Qué se expone con este plugin?

  • 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 sobreescribe cualquier contexto previo. Utilice esto para sincronizar el estado de la aplicación que el reloj necesita mostrar.
  • transferUserInfo - Transferir información de usuario al reloj. Las transferencias se programan y se entregan en orden, incluso si el reloj no está disponible en ese momento. Utilice esto para datos importantes que deben entregarse de manera confiable.
  • replyToMessage - Responder a un mensaje del reloj que solicitó una respuesta. Utilice esto en respuesta al evento messageReceivedWithReply.

Uso de Ejemplo

sendMessage

Enviar un mensaje interactivo al reloj. El reloj debe estar disponible para que esto tenga éxito. Utilice esto para comunicación interactiva y sensible al tiempo.

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

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

updateApplicationContext

Actualizar el contexto de la aplicación compartido con el reloj. Solo se mantiene el contexto más reciente - esto sobreescribe cualquier contexto anterior. Utilice esto para sincronizar el estado de la aplicación que el reloj necesita mostrar.

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

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

transferUserInfo

Transferir información de usuario al reloj. Las transferencias se ponen en cola y se entregan en orden, incluso si el reloj no está disponible actualmente. Utilice esto para datos importantes que deben entregarse de manera confiable.

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

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

replyToMessage

Responder a un mensaje del reloj que solicitó una respuesta. Utilice esto 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

Sigue adelante desde Usando @capgo/capacitor-reloj

Si estás utilizando Usando @capgo/capacitor-reloj para planificar el trabajo de plugin nativo, conectarlo con @capgo/capacitor-reloj para los detalles de implementación en @capgo/capacitor-reloj, Getting Started para los detalles de implementación en Inicio, Directorio de Plugins de Capgo para el flujo de trabajo del producto en el directorio de plugins Capgo Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins.

FAQ

FAQ sobre el plugin de reloj

¿Cómo instalo el plugin de reloj en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-reloj" (o "npm install @capgo/capacitor-reloj"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android capturen el code nativo. Importa desde "@capgo/capacitor-reloj" en tu aplicación code.

¿Funciona @capgo/capacitor-reloj con React, Vue y Angular?

Sí. El reloj 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 soporta @capgo/capacitor-reloj?

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

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

Sí. El código fuente de code está público en GitHub en https://github.com/Cap-go/capacitor-reloj/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza el reloj sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Envía cambios en Watch sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo