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

Watch

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

Guide

Tutoriel sur l'Observation

Utilisation de @capgo/capacitor-watch

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

Installation

bun add @capgo/capacitor-watch
bunx cap sync

Ce que ce Plugin Expose

  • sendMessage - Envoyer un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication sensible au temps, interactive.
  • 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 qui doit être affiché sur l'horloge.
  • transferUserInfo - Transférer des informations d'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.
  • replyToMessage - Répondre à un message de l'horloge qui a demandé une réponse. Utilisez cela en réponse à l'événement messageReceivedWithReply.

Exemple d'utilisation

sendMessage

Envoyez un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive à temps.

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

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

updateApplicationContext

Mettez à 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érez les informations de l'utilisateur à 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épondez à 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 l'utilisation de @capgo/capacitor-watch

Si vous utilisez En utilisant @capgo/capacitor-watch planer les travaux de plugin natif, connectez-le à @capgo/capacitor-watch 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.