Allez directement au contenu principal
Retour aux plugins
@capgo/capacitor-montre
Tutoriel
@capgo/capacitor-montre

Montre

La communication entre l'Apple Watch et les applications iPhone et watchOS avec un échange de messages bidirectionnel

Guide

Tutoriel sur l'horloge

Tester sur appareil

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

Lien QR de prévisualisation du plugin Watch code

Utilisation de @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 - Envoyer un message interactif à la montre. La montre doit être accessible pour que cela réussisse. Utilisez ce pour la communication interactive et sensible à l'heure.
  • updateApplicationContext - Mettre à 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 ce pour synchroniser l'état de l'application que la montre doit afficher.
  • transferUserInfo - Transférer des informations d'utilisateur vers 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 ce pour les données importantes qui doivent être livrées de manière fiable.
  • replyToMessage - Répondre à un message de la montre qui a demandé une réponse. Utilisez ceci en réponse à l'événement messageReceivedWithReply.

Utilisation d'exemple

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 d'Utilisation d'@capgo/capacitor-horloge

Si vous utilisez Utilisation d'@capgo/capacitor-horloge pour planifier le travail de plugin natif, connectez-l’à @capgo/capacitor-montre pour les détails d'implémentation dans @capgo/capacitor-montre, Prise en main pour les détails d'implémentation dans Prise en main, Répertoire des plugins Capgo pour le flux de travail du produit dans Répertoire des plugins Capgo, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajouter ou mettre à jour des plugins.