Informacje o widżetach

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.

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 i SHORT_TEXT, a źródło następnego spotkania może obsługiwać typy SHORT_TEXT i LONG_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 i RANGED_VALUE. Wskaźnik na tarczy zegarka może obsługiwać tylko typ RANGED_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.