Passer à la navigation principale

@capgo/capacitor-montre

Communication entre montre Apple Watch et Wear OS pour Capacitor. Échange bidirectionnel entre téléphone iPhone et watchOS (WatchConnectivity) ou téléphone Android et Wear OS (Data Layer).

@capgo/capacitor-watch connects your Capacitor phone app to a companion watch app:

  • iOS: WatchConnectivity avec une cible watchOS et optionnel CapgoWatchSDK.
  • Android: Layer de données Wear OS (play-services-wearableavec un module Wear OS dans le même projet Android.
  • WebPas pris en charge pour la messagerie de watch. getInfo() et getPluginVersion() resolve with safe defaults; messaging methods reject; listeners register but never deliver events

Capabilités ci-dessous correspondent aux implémentations natives dans CapgoWatchPlugin.swift et CapgoWatchPlugin.java.

CapacitéiOS (Apple Watch)Android (Wear OS)Web
sendMessageOui. Exige une session activée et isReachable.Oui. Envoie sur /capgo/message à des nœuds connectés. Rejette si aucun nœud Wear OS n'est connecté.Non
updateApplicationContextOui. Dernière valeur uniquement via WatchConnectivity.Oui. DonnéeItem à /capgo/context avec JSON dans payload.Non
transferUserInfoOui. Transfert d'informations utilisateur en attente.Oui. DonnéeItem à /capgo/userinfo/{uuid} avec JSON dans payload.Non
replyToMessageOui. Après messageReceivedWithReply.Oui. Envoie sur /capgo/reply/{callbackId} vers le nœud de montre (TTL de 5 minutes en attente).Non
getInfoOui. Pairage et disponibilité de WatchConnectivity.Oui. Nœuds connectés plus capgo_watch capacité de détection d'installation de l'application de montre.Retourne isSupported: false
getPluginVersionOuiOuiRetourne { version: "web" }
messageReceivedOuiOui. En attente /capgo/message.Seuls les enregistrements ; pas d'événements sur le web
messageReceivedWithReplyOuiOui. En attente /capgo/message/withreply.Seuls les enregistrements ; pas d'événements sur le web
applicationContextReceivedOuiOui. En attente /capgo/context DonnéeItem.Seules enregistrements; pas d'événements sur le web
userInfoReceivedOuiOui. En provenance /capgo/userinfo/* (le téléphone supprime l'élément après livraison).Seules enregistrements; pas d'événements sur le web
reachabilityChangedOuiPas émis sur AndroidSeules enregistrements; pas d'événements sur le web
activationStateChangedOuiPas émis sur AndroidSeules enregistrements; pas d'événements sur le web
  • sendMessage - Envoyer un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive et sensible à l'heure.
  • 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 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.
  • replyToMessage - Répondre à un message de l'horloge qui a demandé une réponse. Utilisez cela en réponse à l'événement messageReceivedWithReply.
MéthodeDescription
sendMessageEnvoyez un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive à temps réel.
updateApplicationContextMet à jour le contexte d'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.
transferUserInfoTransfert d'informations 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.
replyToMessageRépondez à un message de l'horloge qui a demandé une réponse. Utilisez cela en réponse à l'événement messageReceivedWithReply.
getInfoObtenez des informations sur l'état de connectivité de l'horloge.
getPluginVersionObtenez la version native du plugin Capacitor.
addListenerÉcoutez les messages reçus de l'horloge.
addListenerÉcoutez les messages de l'horloge qui nécessitent une réponse.
addListenerÉcoutez les mises à jour du contexte d'application de l'horloge.
addListenerListen for user info transfers from the watch.
addListenerÉcoutez les changements de disponibilité de l'horloge (seulement iOS).
addListenerÉcoutez les changements d'état d'activation de session (seulement iOS).
removeAllListenersSupprimez tous les écouteurs pour ce plugin.

Cette référence est synchronisée à partir de src/definitions.ts dans capacitor-horloge.

Si vous utilisez @capgo/capacitor-watch pour planifier la migration et les opérations d'entreprise, connectez-l’avec En utilisant @capgo/capacitor-watch pour la capacité native dans En utilisant @capgo/capacitor-watch Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise Alternatives Ionic Entreprise Plugin pour le flux de travail du produit dans Alternatives Ionic Entreprise Plugin Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, et Capgo Conseil pour le flux de travail du produit dans Capgo Conseil.