Obsługa kliknięć na tarczach zegarka

Użytkownik może wchodzić w interakcje z tarczą zegarka na wiele sposobów. Na przykład użytkownik może dotknąć tarczy zegarka, aby dowiedzieć się, jaki utwór jest obecnie odtwarzany, lub wyświetlić plan dnia. Wear OS by Google pozwala na przyjmowanie przez tarcze zegarka gestu pojedynczego kliknięcia w danym miejscu, o ile nie ma żadnego elementu interfejsu, który również reaguje na ten gest.

Aby zaimplementować interaktywną tarczę zegarka, najpierw utwórz styl tarczy zegarka, a potem zaimplementuj obsługę gestów w sposób opisany w tym przewodniku.

Obsługa zdarzeń kliknięcia

Tarcza zegarka otrzymuje tylko zdarzenia kliknięcia, czyli zdarzeń, w których użytkownik przykłada palec w dół ekranu, a potem go podnosi. Jeśli użytkownik wykona inny gest, gdy palec znajduje się na ekranie dotykowym, na tarczy zegarka zostanie odebrane zdarzenie anulowania, ponieważ system zarezerwuje wszystkie inne gesty dla innych funkcji.

Aby obsługiwać gesty kliknięcia, dodaj element TapListener za pomocą polecenia setTapListener(). Detektor jest wywoływany za każdym razem, gdy użytkownik kliknie tarczę zegarka.

Tarcza zegarka rejestruje te rodzaje zdarzeń dotknięcia:

  • TapType.DOWN: gdy użytkownik przyłoży palec do ekranu dotykowego

  • TapType.UP: gdy użytkownik uniesie palec od ekranu dotykowego

  • TapType.CANCEL: gdy system wykryje, że użytkownik wykonuje gest inny niż kliknięcie.

Zdarzenie TapType.DOWN i kolejne zdarzenie TapType.UP są weryfikowane jako kliknięcie zgodnie z wartością zwracaną przez android.view.ViewConfiguration.getScaledTouchSlop.

Nie wykonuj działania, gdy tarcza zegarka otrzyma zdarzenie TapType.CANCEL, ponieważ system przetwarza już gest.

Więcej informacji: onTapEvent.

Przykładowa aplikacja z tarczą zegarka pokazuje sprawdzone metody konfigurowania tarczy zegarka.