@capgo/capacitor-watch

Aperçu

@capgo/capacitor-watch connecte votre application mobile Capacitor à une application compagnon pour montre :

• iOS: WatchConnectivity avec une cible watchOS et l'optionnel CapgoWatchSDK.
• Android: Couche de données Wear OS (play-services-wearable) avec un module Wear OS dans le même projet Android.
• Le Web: n'est pas pris en charge pour le messaging watch ; getInfo() et getPluginVersion() resolve with safe defaults; messaging methods reject; listeners register but never deliver events

Support des plateformes

Les capacités ci-dessous correspondent aux implémentations natives de CapgoWatchPlugin.swift et CapgoWatchPlugin.java.

Capacité	iOS (Apple Watch)	Android (Wear OS)	Le Web
sendMessage	Oui. Nécessite une session activée et isReachable.	Oui. Envoi lors de /capgo/message aux nœuds connectés. Rejet si aucun nœud Wear OS n'est connecté.	Non
updateApplicationContext	Oui. Dernière valeur uniquement via WatchConnectivity.	Oui. DataItem à /capgo/context avec JSON dans payload.	Non
transferUserInfo	Oui. Transfert des infos utilisateur mis en file d'attente.	Oui. DataItem à /capgo/userinfo/{uuid} avec JSON dans payload.	Non
replyToMessage	Oui. Après messageReceivedWithReply.	Oui. Envoie sur /capgo/reply/{callbackId} au nœud watch (TTL de 5 minutes).	Non
getInfo	Oui. Appairage et reachability WatchConnectivity.	Oui. Nœuds connectés plus capgo_watch capacité de détection d'installation de l'app watch.	Retourne isSupported: false
getPluginVersion	Oui	Oui	Retourne { version: "web" }
messageReceived	Oui	Oui. Entrant /capgo/message.	Enregistrement uniquement ; pas d'événements sur le web
messageReceivedWithReply	Oui	Oui. Entrant /capgo/message/withreply.	Enregistrement uniquement ; pas d'événements sur le web
applicationContextReceived	Oui	Oui. Entrant /capgo/context DataItem.	Enregistrement uniquement ; pas d'événements sur le web
userInfoReceived	Oui	Oui. Entrant /capgo/userinfo/* (le téléphone supprime l'élément après la livraison).	Enregistrement uniquement ; pas d'événements sur le web
reachabilityChanged	Oui	Non émis sur Android	Enregistrement uniquement ; pas d'événements sur le web
activationStateChanged	Oui	Non émis sur Android	Enregistrement uniquement ; pas d'événements sur le web

Guides d'installation

• Créer une application watchOS (Apple Watch + CapgoWatchSDK)
• Créer une app Wear OS (Module Wear + chemins du Data Layer)

Fonctionnalités clés

• 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.

API public

Méthode	Description
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.
getInfo	Obtenir des informations sur l'état de la connectivité de la montre.
getPluginVersion	Récupère la version du plugin natif Capacitor.
addListener	Écouter les messages reçus de la montre.
addListener	Écouter les messages de la montre nécessitant une réponse.
addListener	Écouter les mises à jour du contexte de l'application depuis la montre.
addListener	Écouter les transferts d'informations utilisateur depuis la montre.
addListener	Écouter les changements de connectivité de la montre (iOS uniquement).
addListener	Écouter les changements d'état d'activation de la session (iOS uniquement).
removeAllListeners	Supprimez tous les écouteurs de ce plugin.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-watch.

Continuer depuis @capgo/capacitor-watch

Si vous utilisez @capgo/capacitor-watch pour planifier la migration et les opérations d'entreprise, connectez-l’à Utiliser @capgo/capacitor-watch pour la fonctionnalité native dans « Utiliser @capgo/capacitor-watch », Capgo Enterprise pour le workflow produit dans Capgo Enterprise, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, Alternatives Capgo pour le workflow produit dans les alternatives Capgo, et Conseil Capgo pour le workflow produit chez Capgo Consulting.