Verwenden Sie zum Aufrufen der Data Layer API die Klasse
Wearable
, um Instanzen der verschiedenen Clientklassen abzurufen, z. B.
DataClient
und
MessageClient
.
Weitere Informationen finden Sie in den folgenden Ressourcen:
Hinweis:Die Data Layer API kann nur mit Android-Geräten oder Wear OS-Smartwatches Nachrichten senden und Daten synchronisieren. Das bedeutet, dass die Data Layer API nicht funktioniert, wenn Ihr Wear OS-Gerät mit einem iOS-Gerät gekoppelt ist.
Verwenden Sie die Data Layer API daher nicht als primäre Methode zur Kommunikation mit einem Netzwerk. Folge stattdessen demselben Muster wie in mobilen Apps, mit einigen geringfügigen Unterschieden.
Minimalen Client verwenden
Für den Anfang reicht ein Mindestclient wie im folgenden Beispiel aus. Weitere Informationen finden Sie unter Auf Google APIs zugreifen.
Kotlin
val dataClient: DataClient = Wearable.getDataClient(context)
Java
DataClient dataClient = Wearable.getDataClient(context);
Der Kontext kann ein beliebiger gültiger Android-Kontext sein. Wenn Sie die API im Bereich eines Activity
nutzen, nutzen Sie die Methode getDataClient(activity)
der Klasse Wearable
. Dadurch können bestimmte Interaktionen als Dialogfeld statt als Benachrichtigung angezeigt werden, z. B. wenn der Nutzer aufgefordert wird, seine Version der Google Play-Dienste zu aktualisieren.
Standardmäßig erfolgen Callbacks für Listener im Haupt-UI-Thread der Anwendung.
Wenn Callbacks für einen anderen Thread erfolgen sollen, verwenden Sie ein
WearableOptions
-Objekt, um eine benutzerdefinierte Looper
anzugeben:
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);
Weitere Informationen finden Sie in der Referenz zu
WearableOptions.Builder
.
Die Erstellung von Wearable-API-Clients wie
DataClient
und
MessageClient
ist kostengünstig. Die API-Clients müssen nicht festgehalten werden, sodass Sie sie so oft wie nötig erstellen können. Verwenden Sie den Stil, der zu Ihrer Anwendung passt. Der Clientstatus, z. B. die Gruppe registrierter Listener, wird von allen Clients gemeinsam genutzt und beibehalten, wenn die Google Play-Dienste während der Ausführung einer App aktualisiert werden.