Saltar al contenido principal
Capgo logo
Volver a plugins
@capgo/capacitor-watch
Tutoriales
por github.com/Cap-go

Reloj

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

Descargas/semana

2.0k

GitHub Estrellas

9

Guía

Tutorial de reloj

Usando @capgo/capacitor-watch

Plugin de comunicación con Apple Watch para Capacitor. Proporciona un intercambio bidireccional de mensajes 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 comunicaciones interactivas 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 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.

Ejemplo de uso

sendMessage

Enviar un mensaje interactivo al reloj. El reloj debe estar disponible para que esto tenga éxito. Utilice esto para comunicaciones interactivas de tiempo sensible.

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

Transferir información del usuario al reloj. Las transferencias se enfilan 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.

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

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

replyToMessage

Responder a un mensaje desde el 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