Accéder à la couche de données connectées

Pour appeler l'API Data Layer, utilisez la classe Wearable afin d'obtenir des instances des différentes classes de client, telles que DataClient et MessageClient.

Consultez les ressources associées suivantes :

• Exemple de couche de données

Remarque : L'API Data Layer peut uniquement envoyer des messages et synchroniser des données avec des appareils Android ou des montres Wear OS. Cela signifie que si votre appareil Wear OS est associé à un appareil iOS, l'API Data Layer ne fonctionnera pas.

Pour cette raison, n'utilisez pas l'API Data Layer comme moyen principal de communication avec un réseau. Suivez plutôt le même schéma que dans les applications mobiles, avec quelques différences mineures.

Utiliser un client minimal

Un client minimal, comme illustré dans l'exemple suivant, est suffisant pour commencer. Pour en savoir plus, consultez Accéder aux API Google.

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

Le contexte peut correspondre à n'importe quel contexte Android valide. Si vous utilisez l'API dans le cadre d'une Activity, utilisez la méthode getDataClient(activity) de la classe Wearable. Certaines interactions peuvent ainsi apparaître sous la forme de boîtes de dialogue plutôt que de notifications (par exemple, lorsque l'utilisateur est invité à mettre à jour sa version des services Google Play).

Par défaut, les rappels des écouteurs sont effectués sur le thread UI principal de l'application. Pour effectuer des rappels sur un autre thread, utilisez un objet WearableOptions pour spécifier un Looper personnalisé :

Kotlin

val dataClient: DataClient =
        Wearable.WearableOptions.Builder().setLooper(myLooper).build().let { options ->
            Wearable.getDataClient(context, options)
        }

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

Pour plus d'informations, consultez la documentation de référence sur WearableOptions.Builder.

La création des clients de l'API Wearable, tels que DataClient et MessageClient, est peu coûteuse. Comme il n'est pas nécessaire de les conserver, vous pouvez en créer autant de fois que vous le souhaitez. Utilisez le style qui convient à votre application. L'état du client, tel que l'ensemble des écouteurs enregistrés, est partagé avec tous les clients. Il est conservé en cas de mise à jour des services Google Play pendant l'exécution d'une application.