Pasar al contenido principal
Volver a plugins
@capgo/capacitor-watch
Tutoría
@capgo/capacitor-watch

Sigue

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

Guía

Tutoría sobre Watch

Probar en dispositivo

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

Ver enlace QR de vista previa del plugin code

Usando @capgo/capacitor-watch

Apple Watch communication plugin for Capacitor. Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.

Instalar

bun add @capgo/capacitor-watch
bunx cap sync

¿Qué se expone con este plugin?

  • sendMessage - Enviar un mensaje interactivo a la reloj. La 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 la 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 la reloj necesita mostrar.
  • transferUserInfo - Transferir información de usuario a la reloj. Las transferencias se almacenan en una cola y se entregan en orden, incluso si la reloj no está disponible en ese momento. Utilice esto para datos importantes que deben entregarse de manera confiable.
  • replyToMessage - Responder a un mensaje de 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 comunicaciones interactivas de tiempo sensible.

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 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 del 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-watch, Inicio para el detalle de implementación en Inicio, 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.