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

Seguir

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

Descargas/semana

2.5k

GitHub Estrellas

9

Guía

Tutorial sobre la reloj

Usando @capgo/capacitor-reloj

Plugin de comunicación de reloj Apple para Capacitor. Proporciona mensajería 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 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 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 - 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 de última hora.

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