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

Watch

Communication entre montres Apple et échange de messages bidirectionnels entre les applications iPhone et watchOS

Guide

Tutoriel sur la montre

Utilisation de @capgo/capacitor-montre

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

Install

bun add @capgo/capacitor-watch
bunx cap sync

Ce que cette extension expose

  • sendMessage - Envoie un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive sensible à la durée.
  • updateApplicationContext - Met à 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é par l'horloge.
  • transferUserInfo - Transfère 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 accessible actuellement. 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

Envoie un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive sensible à la durée.

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

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

updateApplicationContext

Met à 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é par l'horloge.

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

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

transferUserInfo

Transfère 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 accessible actuellement. 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 l'utilisation de @capgo/capacitor-watch

Si vous utilisez En utilisant @capgo/capacitor-watch pour planifier le travail de plugin natif, connectez-le à @capgo/capacitor-watch pour les détails d'implémentation dans @capgo/capacitor-watch, Prise en main pour les détails d'implémentation dans Prise en main, Répertoire du plugin Capgo pour le flux de travail du produit dans le répertoire de plugin Capgo Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo, et Ajouter ou Mettre à Jour les Plugins pour le détail d'implémentation dans Ajouter ou Mettre à Jour les Plugins.