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 en Apple Watch

Usando @capgo/capacitor-watch

Plugin de comunicación de Apple Watch para Capacitor. Proporciona mensajería bidireccional entre iPhone y Apple Watch utilizando WatchConnectivity.

Instalar

bun add @capgo/capacitor-watch
bunx cap sync

Qué Este Plugin Exposa

  • sendMessage - Enviar un mensaje interactivo a la reloj. El reloj debe estar accesible para que esto tenga éxito. Utilice esto para comunicación interactiva de tiempo sensible.
  • updateApplicationContext - Actualizar el contexto de la aplicación compartido con la 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 la reloj necesita mostrar.
  • transferUserInfo - Transferir información de usuario a la reloj. Las transferencias se ponen en cola y se entregan en orden, incluso si la reloj no está actualmente accesible. Utilice esto para datos importantes que deben entregarse de manera confiable.
  • replyToMessage - Responder a un mensaje desde la reloj que solicitó una respuesta. Utilice esto en respuesta al evento messageReceivedWithReply.

Ejemplo de uso

sendMessage

Enviar un mensaje interactivo a la reloj. La 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 la reloj. Solo se mantiene el contexto más reciente - esto sobrescribe cualquier contexto previo. Utilice esto para sincronizar el estado de la aplicación que la reloj necesita mostrar.

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

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

transferUserInfo

Transferir información de usuario a la reloj. Las transferencias se almacenan en cola y se entregan en orden, incluso si la 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 desde la 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