Widżet to każda funkcja, która wyświetla się na tarczy zegarka oprócz godziny. Może to być na przykład wskaźnik baterii. Interfejs Complications API jest przeznaczony do tarcz zegarka i aplikacji źródła danych.
W dalszej części tego dokumentu opisujemy źródła danych, tarcze zegarka i typy widżetów.
Źródło danych widżetu
Aplikacje, które przekazują do tarcz zegarka takie informacje jak poziom naładowania baterii, prognoza pogody lub liczba kroków, są nazywane źródłami danych widżetów. Te źródła danych dostarczają nieprzetworzone dane i nie odpowiadają za kontrolowanie sposobu renderowania ich danych na tarczy zegarka. Więcej informacji o tworzeniu aplikacji, które dostarczają dane do tarcz zegarka, znajdziesz w sekcji Ujawnianie danych na widżetach.
Na diagramie poniżej widać, jak Wear OS by Google pośredniczy w przepływie danych ze źródeł do tarcz zegarka.
![Przepływ danych związanych z widżetami Przepływ danych związanych z widżetami](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=0000&hl=pl)
Widżety na tarczach zegarka
Tarcze zegarka otrzymują dane ze źródeł danych widżetów, dzięki czemu mogą uwzględniać widżety bez konieczności użycia kodu do pobierania danych bazowych. Tarcze zegarka zachowują kontrolę nad sposobem renderowania danych, dzięki czemu mogą naturalnie zintegrować dane z projektem. Więcej informacji znajdziesz w przewodniku po projektowaniu dotyczącym kompilacji.
Aby dowiedzieć się, jak dodać widżety do tarczy zegarka, przeczytaj sekcję Dodawanie widżetów do tarczy zegarka.
Typy widżetów
Typy widżetów określają, jakie rodzaje danych mogą być wyświetlane w widżetach lub dostarczane przez źródło danych. Typu SHORT_TEXT
używaj na przykład, gdy dane składają się głównie z krótkiego ciągu znaków. Obiekt
ComplicationData
zawsze ma 1 typ widżetu, który definiuje pola wymagane i opcjonalne. Pole wymagane reprezentuje główny element danych, a większość typów przyjmuje nazwę z pola wymaganego.
Źródła danych używają typów widżetów inaczej niż tarcze zegarka:
- Źródło danych wybiera typy danych widżetów, które mają być dostarczone, w tym informacje o tym, które pola opcjonalne tych typów należy podawać, a także ile różnych typów może być obsługiwanych. Na przykład źródło liczby kroków może obsługiwać typy
RANGED_VALUE
iSHORT_TEXT
, a źródło następnego spotkania może obsługiwać typySHORT_TEXT
iLONG_TEXT
. - Możesz wybrać, ile widżetów ma się wyświetlać na tarczy zegarka i jakie rodzaje widżetów mają być obsługiwane. Na przykład widżet na tarczy zegarka może obsługiwać typy
SHORT_TEXT
,ICON
iRANGED_VALUE
. Wskaźnik na tarczy zegarka może obsługiwać tylko typRANGED_VALUE
.
Więcej informacji o różnych typach widżetów i polach obsługiwanych przez poszczególne typy znajdziesz w artykule o typach widżetów.