Aller au contenu principal
@capgo/capacitor-watch API de l'appareil Open source

Regarder Plugin Capacitor

Communication Apple Watch et Wear OS avec messagerie bidirectionnelle entre les apps du téléphone et de la 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

Comment utiliser Watch dans Capacitor

Utiliser @capgo/capacitor-watch

Plugin de communication Apple Watch pour Capacitor. Permet une messagerie bidirectionnelle entre l'iPhone et l'Apple Watch via WatchConnectivity.

Installer

bun add @capgo/capacitor-watch
bunx cap sync

Ce que ce plugin expose

  • sendMessage - Envoyez un message interactif à la montre. La montre doit être joignable pour que cela fonctionne. Utilisez ceci pour les communications interactives urgentes.
  • updateApplicationContext - Mettez à jour le contexte de l'application partagé avec la montre. Seul le dernier contexte est conservé : il remplace tout contexte précédent. Utilisez ceci pour synchroniser l'état de l'app que la montre doit afficher.
  • transferUserInfo - Transférez les informations utilisateur vers la montre. Les transferts sont mis en file d'attente et livrés dans l'ordre, même si la montre n'est pas joignable sur le moment. Utilisez ceci pour les données importantes qui doivent être livrées de manière fiable.
  • replyToMessage - Répondez à un message de la montre qui a demandé une réponse. Utilisez ceci en réponse à l'événement messageReceivedWithReply.

Exemple d'utilisation

sendMessage

Envoyez un message interactif à la montre. La montre doit être joignable pour que cela fonctionne. Utilisez ceci pour les communications interactives urgentes.

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 la montre. Seul le dernier contexte est conservé : il remplace tout contexte précédent. Utilisez ceci pour synchroniser l'état de l'app que la montre doit afficher.

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

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

transferUserInfo

Transférez les informations utilisateur vers la montre. Les transferts sont mis en file d'attente et livrés dans l'ordre, même si la montre n'est pas joignable sur le moment. Utilisez ceci 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 la montre qui a demandé une réponse. Utilisez ceci 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

Continuer à partir de Utiliser @capgo/capacitor-watch

Si vous utilisez Utiliser @capgo/capacitor-watch pour planifier le travail sur les plugins natifs, connectez-l’à @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 Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.

FAQ

FAQ du plugin Watch

Comment installer le plugin Watch dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-watch" (ou "npm install @capgo/capacitor-watch"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-watch" dans votre code.

Est-ce que @capgo/capacitor-watch fonctionne avec React, Vue et Angular ?

Oui. Watch est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript vanilla.

Quelle version de Capacitor est supportée par @capgo/capacitor-watch ?

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 le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

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

Oui. Le code source est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-watch/ et le package s'installe gratuitement depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

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

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements Watch sans attendre la validation de l’app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo