Les API de la couche de données Wear OS se composent de plusieurs types de clients, qui sont utiles pour différents types de données et dans différentes conditions de connectivité.
Cette page présente chaque type de client et comprend un tableau qui compare les fonctionnalités des différents clients. Grâce à ces informations, vous pouvez sélectionner l'ensemble de types de clients qui convient le mieux à votre application.
Client de données
Un objet DataClient vous permet de lire ou d'écrire dans un DataItem ou un Asset:
Chaque
DataItemest une unité d'informations diffusée et synchronisée sur tous les appareils à proximité appartenant à un utilisateur. UnDataItemest stocké de manière persistante, et votre appareil peut lire son contenu jusqu'à ce que l'élément de données soit supprimé.Un
Assetest destiné à des charges utiles de données plus importantes, telles que des images ou des fichiers multimédias.
Client de messages
Un objet MessageClient peut envoyer des messages et convient pour les appels de procédure à distance (RPC), tels que l'utilisation d'un appareil Wear OS pour contrôler la version de votre application installée sur un appareil portable.
Les messages conviennent parfaitement pour les requêtes unidirectionnelles à l'aide de sendMessage() ou pour un modèle de communication requête-réponse à l'aide de sendRequest(). Contrairement aux clients de données, les clients de messages ont besoin que les nœuds soient connectés au réseau pour envoyer des messages.
La méthode sendMessage() s'efforce de transmettre les données au nœud distant, mais ne contient aucun mécanisme de nouvelle tentative intégré. Si l'appareil cible se déconnecte avant le début du transfert réseau, la méthode renvoie TARGET_NODE_NOT_CONNECTED.
Client de canaux
Un objet ChannelClient fournit une communication orientée flux entre les appareils. Un canal est un canal de communication bidirectionnel entre deux nœuds, ce qui est utile pour les cas d'utilisation suivants:
- Transférer des fichiers de données entre plusieurs appareils connectés lorsque la connexion Internet n'est pas disponible
ChannelClientpermet d'économiser de l'espace disque surDataClient, ce qui crée une copie des éléments sur l'appareil local avant la synchronisation avec les appareils connectés. - Envoyer de manière fiable un fichier trop volumineux pour l'envoi à l'aide d'un
MessageClient. - Transférer des données diffusées, telles que des données vocales depuis le micro.
Une fois que vous avez ouvert un canal, vous pouvez envoyer et recevoir des données dans un flux d'octets continu, plutôt que dans les unités DataItem distinctes requises par les clients de données.
Vous êtes responsable de la gestion du flux de données et de la cohérence des données. Les clients de canaux n'offrent pas le même niveau de synchronisation automatique des données que les clients de données.
Comparaison des clients
Le tableau suivant compare les fonctionnalités des différents clients:
| Type de client | Persistance des données | Accepte-t-il les données de plus de 100 ko ? | Réseau à utiliser | Fonctionne hors connexion ? |
|---|---|---|---|---|
| Client de données | Les données sont conservées indéfiniment | Oui (utilisez des objets Asset) |
Bluetooth de préférence. Les données sont sauvegardées dans le cloud. Si le Bluetooth est disponible, cette sauvegarde est effectuée de manière asynchrone. | Oui, pour la lecture et l'écriture |
| Client de messages | Pas de persistance ni de nouvelle tentative | Non | Bluetooth recommandé, mais vous pouvez utiliser le Wi-Fi si c'est le seul type de connexion disponible | Non |
| Client de canaux | Aucune persistance (orientée connexion) | Oui | Bluetooth recommandé, mais vous pouvez utiliser le Wi-Fi si c'est le seul type de connexion disponible | Non |