Informacje o widżetach

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.

Rysunek 1. Przepływ danych do widżetu.

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 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, 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 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 sekcji Typy widżetów.