Aller directement au contenu principal
@capgo/capacitor-montre APIs de dispositifs Source ouvert

Montre plugin Capacitor

Communication entre montre Apple Watch et Wear OS avec un échange bidirectionnel de messages entre les applications de téléphone et de montre

Installer

bun add @capgo/capacitor-watch bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-watch
  • pnpm add @capgo/capacitor-watch
  • yarn add @capgo/capacitor-watch

Guide

How to utiliser Watch dans Capacitor

Utilisation de @capgo/capacitor-watch

Plugin de communication Apple Watch pour Capacitor. Propose une messagerie bidirectionnelle 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 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

Transfert d'informations 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 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 la montre 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-montre

Si vous utilisez L'utilisation de @capgo/capacitor-montre pour planifier le travail de plugin natif, connectez-l’avec @capgo/capacitor-montre pour les détails d'implémentation dans @capgo/capacitor-montre Getting Started 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.

FAQ

FAQ du plugin Montre

Comment installer le plugin Montre dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-montre » (ou « npm install @capgo/capacitor-montre »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le projet natif code. Importez-l’à partir de « @capgo/capacitor-montre » dans votre application code.

Le plugin @capgo/capacitor-montre fonctionne-t-il avec React, Vue et Angular?

Oui. Le plugin Montre est un package Capacitor, il fonctionne donc avec tout framework web qui fonctionne à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript simple.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-montre?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-watch est gratuit et open source ?

Oui. Le code source code est public sur GitHub à https://github.com/Cap-go/capacitor-watch/ et le package est gratuit pour l'installation depuis npm. Les rapports de bugs et les demandes de mise à jour sont les bienvenus.

Puis-je mettre à jour code sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin modifie le code natif code, il faut donc une nouvelle version du magasin. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être envoyées instantanément avec les mises à jour Capgo.

Ship Watch changes without waiting for app review

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrez avec Capgo