Auf Wearable-Datenschicht zugreifen

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.