Dodaj widżety do tarczy zegarka

Widżet na tarczę zegarka wyświetla dane ze źródła danych. Korzystając z formatu tarczy zegarka, możesz wybrać źródła danych, z których chcesz pobrać dane. Dzięki temu na tarczy zegarka wyświetlają się informacje poza porą dnia, nie wymaga to kodu do pobierania danych.

Użyj formatu tarczy zegarka

Element Complication pozwala zdefiniować do 8 widżetów w ramach jednej tarczy zegarka. Element pozwala też określić, w którym miejscu pojawi się widżet na tarczy zegarka.

Więcej informacji znajdziesz w przykładzie WatchFaceFormat na GitHubie.

Typy i pola

W tabeli poniżej opisujemy typy i pola obiektu ComplicationData. Jeśli tarcza zegarka żąda pola, które jest nieprawidłowe w przypadku danego typu widżetu, zwracana jest domyślna wartość tego pola. Jeśli na przykład tarcza zegarka próbuje uzyskać dostęp do pola LONG_TEXT w typie SHORT_TEXT, zwracana jest domyślna wartość pola LONG_TEXT (null). Uwaga: nie ma gwarancji, że opcjonalne pola będą się wyświetlać.





Typ Pola wymagane Pola opcjonalne Uwagi
SHORT_TEXT Krótki tekst Ikona
Ikona ochrony przed wypaleniem
Krótki tytuł
Opis treści

 Jeśli przesłano jedną lub obie z tych ikon, wyświetla się tylko 1 ikona lub krótki tytuł.
MONOCHROMATIC_IMAGE Obraz monochromatyczny
 Ikona ochrony przed wypaleniem
Opis treści

 Jest używana, gdy tekst nie jest potrzebny. Ikona powinna być jednokolorowa i może być przyciemniona przez tarczę zegarka.
RANGED_VALUE Wartość
Wartość minimalna
Wartość maksymalna
 Obraz monochromatyczny
Ikona ochrony przed wypaleniem
Krótki tekst
Krótki tytuł
Rampa kolorów
Wartość dynamiczna
Opis treści

 Jeśli chcesz narysować własny pasek postępu, możesz użyć metody isRangedValueProgressHidden() do ukrycia paska postępu udostępnianego przez klasę ComplicationDrawable.
GOAL_PROGRESS Wartość
Wartość docelowa
 Obraz monochromatyczny
Ikona ochrony przed wypaleniem
Krótki tekst
Krótki tytuł
Rampa kolorów
Wartość dynamiczna
Opis treści

 GOAL_PROGRESS jest przeznaczony na takie parametry, jak liczba kroków, w których Wartość zaczyna się od zera, i może przekraczać wartość docelową.
LONG_TEXT Długi tekst
 Długi tytuł
Obraz monochromatyczny
Ikona ochrony przed wypaleniem
Mały obraz
Opis treści
 Wyświetla długi tytuł, jeśli został podany.
SMALL_IMAGE Mały obraz
 Opis treści
 Mały obraz ma jeden z dwóch stylów: styl zdjęcia lub styl ikony. Styl zdjęcia oznacza, że powinno wypełniać przestrzeń i może zostać przycięte. Styl ikony oznacza, że nie można jej przyciąć ani dopełnić. Zmienność obrazu może spowodować, że obraz nie nadaje się do wyświetlania w trybie nieaktywnym na urządzeniach z ochroną przed wypaleniem pikseli lub w trybie niskiej jakości dźwięku. Gdy włączona jest ochrona przed wypaleniem lub niskie dźwięki otoczenia, tarcza zegarka może korzystać z małego obrazu ochrony przed wypaleniem, ponieważ jest bezpieczny. W przeciwnym razie, ponieważ tarcza ma problem z określeniem dopasowania, zdjęcie nie jest wyświetlane.
LARGE_IMAGE Duży obraz
 Opis treści
 Ten obraz powinien być wystarczająco duży, by wypełnić tarczę zegarka. Zmienność obrazu może spowodować, że obraz nie nadaje się do wyświetlania w trybie nieaktywnym na urządzeniach z ochroną przed wypaleniem pikseli lub w trybie niskiej jakości dźwięku. Ponieważ tarcza zegarka trudno jest stwierdzić, czy jest odpowiednia do wyświetlacza, tarcza nie wyświetla obrazu w trybie nieaktywnym, jeśli włączona jest ochrona przed wypaleniem lub masz włączoną ochronę przed wypaleniem.
WEIGHTED_ELEMENTS Lista elementów
 Obraz monochromatyczny
Ikona ochrony przed wypaleniem
Krótki tekst
Krótki tytuł
Opis treści
 Każdy element składa się z koloru i wagi (większej od zera). Rozmiar renderowanego elementu powinien być proporcjonalny do jego wagi. Wagi nie muszą sumować się do żadnej konkretnej wartości. Pamiętaj, że tarcze zegarka mogą zmieniać kolor WEIGHTED_ELEMENTS.

W tabeli poniżej opisujemy typy widżetów związanych z pustymi danymi, które można wysłać w przypadku dowolnego przedziału widżetów. Te typy nie mają pól i nie muszą być uwzględnione na liście obsługiwanych typów. Dzięki nim można odróżnić te 3 przypadki:

  • Nie wybrano źródła
  • Użytkownik wybrał „puste” w przypadku boksu
  • Źródło nie ma danych do wysłania

Źródła nie mogą wysyłać TYPE_EMPTY w odpowiedzi na żądania aktualizacji. Zamiast tego wyślij TYPE_NO_DATA.

Typ widżetu Opis
TYPE_NOT_CONFIGURED Wysyłane przez system, gdy widżet się aktywuje, ale użytkownik nie wybrał źródła ani nie ustawiono żadnej wartości domyślnej.

Nie można wysłać ze źródeł.

TYPE_EMPTY Wysyłane przez system, gdy widżet się aktywuje, a użytkownik wybierze „pusty” zamiast źródła lub gdy tarcza zegarka nie wybierze żadnego źródła, a ten rodzaj widżetu jest ustawiony jako domyślny.

Nie można wysłać ze źródeł.

TYPE_NO_DATA Wysyłane przez system, gdy widżet ze źródłem zostanie aktywowany, aby usunąć widżet przed otrzymaniem rzeczywistych danych ze źródła.

Można ją wysyłać ze źródeł, jeśli nie mają one rzeczywistych danych do wysłania.

Większość źródeł danych wymaga formatu tarczy zegarka

Aby zachować wygląd widżetów na tarczy zegarka w nadchodzących wersjach Wear OS, musisz użyć formatu tarczy zegarka. Jeśli tarcza zegarka korzysta z biblioteki tarczy zegarka Jetpack lub biblioteki pomocy do noszenia, nowsze wersje Wear OS nie wyświetlają danych z większości źródeł danych w widżetach tarczy zegarka.

Aby w pełni zachować wygląd widżetów na tarczach, które nie korzystają z formatu tarczy zegarka, muszą one korzystać w boksach widżetów z jednego z tych źródeł danych:

W zależności od producenta urządzenia, które nie używają formatu tarczy zegarka, może pojawić się kilka dodatkowych źródeł widżetów.