Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-montre
Tutoriel
@capgo/capacitor-montre

Montre

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

Guide

Tutoriel sur Watch

Tester sur appareil

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

Prévisualisation du lien QR du plugin Watch code

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.

Installer

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 interactive à temps.
  • 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.
  • transferUserInfo - Transférer des informations d'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 des 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

Envoyer 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

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 l'utilisation de @capgo/capacitor-horloge

Si vous utilisez L'utilisation de @capgo/capacitor-horloge pour planifier le travail de plugin natif, connectez-l’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.