Aby wywołać interfejs Data Layer API, użyj klasy
Wearable
do pobrania instancji różnych klas klienta, takich jak
DataClient
i
MessageClient
.
Zapoznaj się z tymi powiązanymi materiałami:
Uwaga: interfejs Data Layer API może wysyłać wiadomości i synchronizować dane tylko z urządzeniami z Androidem lub zegarkami z Wear OS. Oznacza to, że jeśli Twoje urządzenie z Wear OS jest sparowane z urządzeniem z iOS, interfejs Data Layer API nie będzie działać.
Z tego powodu nie używaj interfejsu Data Layer API jako podstawowej metody komunikacji z siecią. Zamiast tego postępuj według tego samego wzorca co w przypadku aplikacji mobilnych, z kilkoma drobnymi różnicami.
Użyj minimalnej wersji klienta
Na początek wystarczy minimalna liczba klientów, zgodnie z przykładem poniżej. Więcej informacji znajdziesz w artykule na temat dostępu do interfejsów API Google.
Kotlin
val dataClient: DataClient = Wearable.getDataClient(context)
Java
DataClient dataClient = Wearable.getDataClient(context);
Kontekstem może być dowolny prawidłowy kontekst na urządzeniach z Androidem. Jeśli używasz interfejsu API w zakresie obiektu Activity
, użyj metody getDataClient(activity)
klasy Wearable
. Dzięki temu niektóre interakcje mogą wyświetlać się jako okna, a nie powiadomienia, na przykład gdy użytkownik jest proszony o zaktualizowanie wersji Usług Google Play.
Domyślnie wywołania zwrotne do detektorów są wykonywane w głównym wątku interfejsu aplikacji.
Aby wywołania zwrotne były wykonywane w innym wątku, użyj obiektu
WearableOptions
do określenia niestandardowego parametru Looper
:
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);
Więcej informacji znajdziesz w dokumentacji
WearableOptions.Builder
.
Klienty interfejsu API do noszenia, takie jak
DataClient
i
MessageClient
, są niedrogie w tworzeniu. Klienty interfejsu API nie muszą być utrzymywane, więc możesz je tworzyć tyle razy, ile potrzebujesz. Użyj stylu, który pasuje do Twojej aplikacji. Stan klienta, np. zbiór zarejestrowanych detektorów, jest udostępniany wszystkim klientom i jest zachowywany, jeśli Usługi Google Play są aktualizowane podczas działania aplikacji.