Informacje o widżetach

Widżet to dowolna funkcja wyświetlana na tarczy zegarka obok godziny. Na przykład wskaźnik baterii jest widżetem. Interfejs Complications API jest przeznaczony zarówno dla tarcz zegarka, jak i aplikacji będących źródłami danych.

W pozostałej części tego dokumentu opisujemy źródła danych, tarcze zegarka i typy komplikacji.

Źródło danych widżetu

Aplikacje, które dostarczają dane, takie jak poziom baterii, pogoda lub liczba kroków, na tarcze zegarka w celu wyświetlania ich w postaci widżetów, nazywane są źródłami danych widżetów. Te źródła danych dostarczają nieprzetworzone dane i nie odpowiadają za sposób ich wyświetlania na tarczy zegarka. Więcej informacji o pisaniu aplikacji, które udostępniają dane tarczom zegarka, znajdziesz w artykule Udostępnianie danych widżetom.

Ten diagram pokazuje, jak Wear OS by Google pośredniczy w przepływie danych ze źródeł na tarcze zegarka.

Przepływ danych widżetów
Rysunek 1. Przepływ danych widżetu.

Widżety na tarczach zegarka

Tarcze zegarka otrzymują dane ze źródeł danych komplikacji, co pozwala im uwzględniać komplikacje bez konieczności pisania kodu do pobierania danych bazowych. Tarcze zegarka zachowują kontrolę nad sposobem renderowania danych, dzięki czemu mogą naturalnie integrować dane z własnym projektem. Więcej informacji znajdziesz w przewodniku po projektowaniu komplikacji.

Aby dowiedzieć się, jak dodawać widżety do tarczy zegarka, przeczytaj artykuł 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żecie lub dostarczane przez źródło danych. Na przykład użyj typu SHORT_TEXT, gdy dane składają się głównie z krótkiego ciągu znaków. Obiekt A ComplicationData zawsze ma jeden typ komplikacji, który określa wymagane i opcjonalne pola. Pole wymagane reprezentuje podstawowy element danych. Większość typów bierze swoją nazwę od pola wymaganego.

Źródła danych używają typów komplikacji inaczej niż tarcze zegarka:

  • Źródło danych wybiera typy danych komplikacji, które ma dostarczać, w tym opcjonalne pola tych typów, oraz liczbę różnych typów, które mogą być obsługiwane. Na przykład źródło danych dotyczących liczby kroków może obsługiwać typy RANGED_VALUE i SHORT_TEXT, a źródło danych dotyczących następnego spotkania może obsługiwać typy SHORT_TEXT i LONG_TEXT.
  • Możesz wybrać, ile widżetów ma być wyświetlanych na tarczy zegarka, oraz typy widżetów, które mają być obsługiwane. Na przykład widżet na tarczy zegarka może obsługiwać typy SHORT_TEXT, SMALL_IMAGE i RANGED_VALUE. Wskaźnik na tarczy zegarka może obsługiwać tylko typ RANGED_VALUE.

Więcej informacji o różnych typach komplikacji i polach obsługiwanych przez każdy typ znajdziesz w sekcji Typy komplikacji.