Saltar al contenido principal
Volver a plugins
@capgo/capacitor-reloj
Tutorial
@capgo/capacitor-reloj

Reloj

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

Guía

Tutoriales sobre Watch

Probar en dispositivo

Descarga la aplicación Capgo, escanea el código QR code.

Enlace QR de vista previa del plugin de reloj code

Usando @capgo/capacitor-watch

Plugin de comunicación de reloj de Apple para Capacitor. Proporciona un intercambio de mensajes bidireccional entre iPhone y Apple Watch utilizando 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 la comunicación interactiva y sensible al tiempo.
  • 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 de usuario al reloj. Las transferencias se programan y se envían 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 la comunicación interactiva y sensible al tiempo.

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

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

updateApplicationContext

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

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

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

transferUserInfo

Transfiera información de usuario al reloj. Las transferencias se enfilan y se entregan en orden, incluso si el reloj no está actualmente accesible. 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

Siga adelante desde Usando @capgo/capacitor-reloj

Si está utilizando Usando @capgo/capacitor-reloj para planificar el trabajo de plugin nativo, conecte con @capgo/capacitor-reloj para el detalle de implementación en @capgo/capacitor-reloj, Iniciación para el detalle de implementación en Iniciación, Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins.