Passer au contenu principal
Retour aux plugins
@capgo/capacitor-watch
Tutoriel
@capgo/capacitor-watch

Watch

Communication entre Apple Watch et iPhone avec un échange de messages bidirectionnel entre les applications watchOS et iPhone

Guide

Tutoriel sur Watch

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Regardez le lien QR de prévisualisation du plugin code

En utilisant @capgo/capacitor-watch

Plugin de communication pour montre Apple Capacitor. fournit un échange de messages bidirectionnel entre iPhone et montre Apple à l'aide de WatchConnectivity.

Installer

bun add @capgo/capacitor-watch
bunx cap sync

Ce que ce plugin expose

  • sendMessage - Envoyez un message interactif à la montre. La montre doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive à temps réel.
  • updateApplicationContext - Mettez à jour le contexte de l'application partagé avec la montre. Seul le contexte le plus récent est conservé - cela remplace tout contexte précédent. Utilisez cela pour synchroniser l'état de l'application que la montre doit afficher.
  • transferUserInfo - Transférez des informations d'utilisateur à la montre. Les transferts sont en file d'attente et sont livrés dans l'ordre, même si la montre n'est pas actuellement accessible. Utilisez cela pour les données importantes qui doivent être livrées de manière fiable.
  • replyToMessage - Répondez à un message de la montre qui a demandé une réponse. Utilisez cela en réponse à l'événement messageReceivedWithReply.

Exemple d'utilisation

sendMessage

Envoyez un message interactif à la montre. La montre doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive à temps réel.

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

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

updateApplicationContext

Mettre à jour le contexte de l'application partagé avec l'horloge. Seul le contexte le plus récent est conservé - cela remplace tout contexte précédent. Utilisez cela pour synchroniser l'état de l'application que l'horloge doit afficher.

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

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

transferUserInfo

Transférer les informations de l'utilisateur vers l'horloge. Les transferts sont en file d'attente et sont livrés dans l'ordre, même si l'horloge n'est pas actuellement accessible. Utilisez cela pour les données importantes qui doivent être livrées de manière fiable.

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

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

replyToMessage

Répondre à un message de l'horloge qui a demandé une réponse. Utilisez cela en réponse à l'événement 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 }
  });
});

Référence complète

Continuez à partir de Utiliser @capgo/capacitor-horloge

Si vous utilisez Utiliser @capgo/capacitor-horloge pour planifier le travail de plugin natif, connectez-le avec @capgo/capacitor-horloge pour les détails d'implémentation dans @capgo/capacitor-watch, Démarrage pour les détails d'implémentation dans Démarrage, Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo, et Ajouter ou Mettre à Jour les Plugins pour les détails d'implémentation dans Ajouter ou Mettre à Jour les Plugins.