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:
DATA_SOURCE_WATCH_BATTERY
DATA_SOURCE_APP_SHORTCUT
DATA_SOURCE_UNREAD_NOTIFICATION_COUNT
DATA_SOURCE_DATE
DATA_SOURCE_TIME_AND_DATE
DATA_SOURCE_DAY_OF_WEEK
DATA_SOURCE_DAY_AND_DATE
DATA_SOURCE_WORLD_CLOCK
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.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- DefaultProviderPolicy
- ComplicationSlot.
- Widżet