Vue d'ensemble
Section titled “Overview”@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()etgetPluginVersion()resolve with safe defaults; messaging methods reject; listeners register but never deliver events
Support de plateforme
Section titled “Platform support”Capabilités ci-dessous correspondent aux implémentations natives dans CapgoWatchPlugin.swift et CapgoWatchPlugin.java.
| Capacité | iOS (Apple Watch) | Android (Wear OS) | Web |
|---|---|---|---|
sendMessage | Oui. 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 |
updateApplicationContext | Oui. Dernière valeur uniquement via WatchConnectivity. | Oui. DonnéeItem à /capgo/context avec JSON dans payload. | Non |
transferUserInfo | Oui. Transfert d'informations utilisateur en attente. | Oui. DonnéeItem à /capgo/userinfo/{uuid} avec JSON dans payload. | Non |
replyToMessage | Oui. Après messageReceivedWithReply. | Oui. Envoie sur /capgo/reply/{callbackId} vers le nœud de montre (TTL de 5 minutes en attente). | Non |
getInfo | Oui. 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 |
getPluginVersion | Oui | Oui | Retourne { version: "web" } |
messageReceived | Oui | Oui. En attente /capgo/message. | Seuls les enregistrements ; pas d'événements sur le web |
messageReceivedWithReply | Oui | Oui. En attente /capgo/message/withreply. | Seuls les enregistrements ; pas d'événements sur le web |
applicationContextReceived | Oui | Oui. En attente /capgo/context DonnéeItem. | Seules enregistrements; pas d'événements sur le web |
userInfoReceived | Oui | Oui. En provenance /capgo/userinfo/* (le téléphone supprime l'élément après livraison). | Seules enregistrements; pas d'événements sur le web |
reachabilityChanged | Oui | Pas émis sur Android | Seules enregistrements; pas d'événements sur le web |
activationStateChanged | Oui | Pas émis sur Android | Seules enregistrements; pas d'événements sur le web |
Guides de configuration
Section intitulée « Guides de configuration »- Créer une application Apple Watch (Apple Watch + CapgoWatchSDK)
- Créer une application Wear OS (Module Wear + Chemins de la couche de données)
Capacités de base
Section intitulée « Capacités de base »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.
Public API
Section intitulée « Public API »| Méthode | Description |
|---|---|
sendMessage | Envoyez un message interactif à l'horloge. L'horloge doit être accessible pour que cela réussisse. Utilisez cela pour la communication interactive à temps réel. |
updateApplicationContext | Met à 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. |
transferUserInfo | Transfert 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. |
replyToMessage | Répondez à un message de l'horloge qui a demandé une réponse. Utilisez cela en réponse à l'événement messageReceivedWithReply. |
getInfo | Obtenez des informations sur l'état de connectivité de l'horloge. |
getPluginVersion | Obtenez 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. |
addListener | Listen 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). |
removeAllListeners | Supprimez tous les écouteurs pour ce plugin. |
Source De Vérité
Section intitulée « Source De Vérité »Cette référence est synchronisée à partir de src/definitions.ts dans capacitor-horloge.
Continuez à partir de @capgo/capacitor-horloge
Section intitulée « Continuez à partir de @capgo/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.