Widżet to dowolna funkcja wyświetlana na tarczy zegarka oprócz godziny. Na przykład wskaźnik baterii jest widżetem. Interfejs Complications API jest przeznaczony zarówno do tarczy zegarka, jak i do aplikacji źródeł danych.
W pozostałej części tego dokumentu znajdziesz opis źródeł danych, tarcz zegarka i typów widżetów.
Źródło danych widżetu
Aplikacje, które w przypadku widżetów przekazują do tarcz zegarka dane takie jak poziom naładowania baterii, pogoda czy 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 na tarczy zegarka. Aby dowiedzieć się, jak pisać aplikacje, które przekazują dane do tarcz zegarka, przeczytaj artykuł o udostępnianiu danych widżetom.
Na diagramie poniżej widać, jak Wear OS by Google pośredniczy w przepływie danych ze źródeł na tarcze zegarka.
Widżety na tarczach zegarka
Tarcze zegarka otrzymują dane ze źródeł danych widżetów, co pozwala uwzględniać widżety bez konieczności instalowania kodu do pobierania danych bazowych. Tarcze zegarka zachowują kontrolę nad sposobem renderowania danych, dzięki czemu mogą naturalnie zintegrować dane ze swoim projektem. Więcej informacji znajdziesz w przewodniku projektowania dotyczącym komplikacji.
Uwaga: w nadchodzących wersjach Wear OS tarcze zegarka będą musiały używać formatu tarczy zegarka, aby obsługiwały widżety zawierające dane użytkownika. Zalecamy zaktualizowanie tarczy zegarka, aby używała formatu tarczy zegarka. Dowiedz się więcej o tych zmianach w widżetach.
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 dane mogą być wyświetlane w widżecie lub dostarczane przez źródło danych. Na przykład, gdy dane składają się głównie z krótkiego ciągu znaków, użyj typu SHORT_TEXT
. Obiekt
ComplicationData
zawsze ma jeden typ widżetu, który określa pola wymagane i opcjonalne. Pole wymagane reprezentuje podstawowe dane; większość typów pobiera swoją 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 komplikacji do dostarczenia, w tym typy pól opcjonalnych tych typów, które mają zostać dostarczone, oraz liczbę obsługiwanych typów, które mogą być obsługiwane. Na przykład źródło z liczbą 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, oraz jakie typy widżetów mają być obsługiwane. Na przykład widżet z tarczą 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 sekcji Typy widżetów.