Les appareils peuvent établir une connexion à Internet directement à l'aide d'une connexion Wi-Fi ou mobile, ou indirectement via un appareil Bluetooth associé.
Nœuds accessibles et à proximité
Un appareil est considéré comme accessible lorsqu'il est en ligne et disponible pour communiquer avec un autre appareil, soit directement via le Bluetooth, soit indirectement en utilisant le cloud comme intermédiaire.
Un appareil est considéré comme à proximité s'il peut être connecté directement via le Bluetooth, sans utiliser le cloud.
Activités ayant une incidence sur le temps de reconnexion
Dans certains cas, les appareils peuvent mettre jusqu'à quatre minutes pour rétablir une connexion. Ces scénarios incluent les suivants :
- Inactivité de l'appareil Wear OS : si un appareil Wear OS est retiré du poignet de l'utilisateur ou n'est pas utilisé activement pendant une période prolongée, le délai de reconnexion peut être prolongé.
- Mode Doze : le mode Doze d'économie d'énergie d'un appareil portable peut limiter les processus en arrière-plan, ce qui peut augmenter le temps de reconnexion de l'appareil.
- Interaction de l'utilisateur : si l'utilisateur commence à interagir avec un appareil portable et un appareil Wear OS à peu près en même temps, cela accélère souvent le processus de reconnexion.
Découvrir tous les appareils à l'aide d'un client de nœud
Un objet NodeClient identifie et diffuse la liste des appareils Android connectés à un réseau, quelles que soient les fonctionnalités de chaque appareil. Toutes les applications d'un appareil reçoivent ces notifications d'événements, par exemple lorsqu'un nouvel appareil rejoint le réseau ou qu'un appareil existant se déconnecte.
La classe NodeClient est particulièrement utile pour détecter les appareils sur lesquels votre application n'est pas installée.
Pour vous inscrire aux événements de connexion et de déconnexion d'un appareil, vous pouvez utiliser la classe Horologist DataLayerAppHelper. Il fournit un connectedAndInstalledNodes Flow pour observer l'état de la connexion. De plus, sa méthode connectedNodes() renvoie une liste d'appareils connectés, en combinant les informations de NodeClient et de CapabilityClient dans un seul objet.
Découvrir des appareils spécifiques à l'aide d'un client de fonctionnalités
Un objet CapabilityClient fournit des informations sur les appareils du réseau Wear OS qui prennent en charge des fonctionnalités d'application spécifiques. Une capacité est une fonctionnalité qu'une application définit au moment de la compilation ou configure de manière dynamique au moment de l'exécution.
Par exemple, une application Android mobile peut annoncer qu'elle prend en charge la télécommande pour la lecture de vidéos. La version Wear OS de cette application peut utiliser le CapabilityClient pour vérifier si la version mobile de l'application est installée sur un appareil à proximité et si elle est compatible avec cette fonctionnalité. Si c'est le cas, l'application Wear OS peut afficher des boutons de lecture et de mise en pause pour que les utilisateurs puissent contrôler une vidéo en cours de lecture sur leur appareil mobile depuis leur appareil Wear OS. La diffusion des capacités fonctionne également dans le sens inverse : les applications Wear OS peuvent lister les capacités qu'elles prennent en charge.
Pour définir des capacités au moment de la compilation, déclarez une ressource string-array nommée android_wear_capabilities dans res/values/wear.xml, comme indiqué dans Spécifier des noms de fonctionnalités permettant de détecter vos applications. Pour éviter que la réduction des ressources ne supprime android_wear_capabilities, car elle est inutilisée, spécifiez tools:keep="@array/android_wear_capabilities" dans un fichier de conservation distinct du répertoire res/raw/ (par exemple, res/raw/keep.xml) plutôt que dans res/values/wear.xml. Pour connaître la syntaxe du fichier keep, consultez Personnaliser les ressources à conserver.
Découvrez les nouvelles fonctionnalités de votre application
Utilisez CapabilityClient pour déterminer l'ID de nœud d'un appareil avec lequel vous devez communiquer. Par exemple, si vous devez vérifier la présence d'une nouvelle fonctionnalité dans votre application sur les appareils portables, créez une capacité pour cette nouvelle fonctionnalité côté appareil portable. Votre application Wear OS peut ensuite interroger les appareils compatibles avec cette fonctionnalité. Si la fonctionnalité est manquante sur tous les appareils, cela signifie que l'utilisateur ne dispose pas d'une version de votre application compatible avec cette fonctionnalité, que vous devez gérer correctement dans la logique de votre application. Si vous supposez que l'appareil portable est toujours le bon nœud avec lequel communiquer, il se peut que vos messages ne soient pas distribués, car l'application Téléphone n'est pas compatible avec cette fonctionnalité.
Déterminer si un appareil Wear OS est le seul sur un réseau
Vous pouvez utiliser CapabilityClient pour vérifier si votre application doit fonctionner en mode autonome, car aucun autre appareil Android n'est à proximité. En transmettant FILTER_ALL, aucun autre appareil ne doit apparaître dans les résultats.