Dostęp do warstwy danych urządzenia do noszenia

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.