Informacje o widżetach

A widżet to dowolna funkcja, która wyświetla się na tarczy zegarka obok godziny. Przykładem widżetu jest wskaźnik baterii. Interfejs Complications API jest przeznaczony zarówno dla tarcz zegarka, jak i aplikacji źródła danych.

W pozostałej 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 udostępniają tarczy zegarka dane takie jak poziom baterii, pogoda czy liczba kroków, nazywamy ź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. Aby dowiedzieć się, jak pisać aplikacje, które udostępniają dane tarczom zegarka, przeczytaj artykuł Udostępnianie danych widżetom.

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 w widżetach
Rysunek 1. Przepływ danych widżetów.

Widżety na tarczach zegarka

Tarcze zegarka otrzymują dane ze źródeł danych widżetów, co pozwala im uwzględniać widżety bez konieczności pisania kodu do pobierania danych źródłowych. Tarcze zegarka zachowują kontrolę nad sposobem wyświetlania danych, dzięki czemu mogą naturalnie integrować dane z ich wyglądem. Więcej informacji znajdziesz w przewodniku po projektowaniu dotyczącym widżetów.

Aby dowiedzieć się, jak dodać 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, jeśli 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 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 widżetów inaczej niż tarcze zegarka:

  • Źródło danych wybiera typy danych widżetów, 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 liczby kroków może obsługiwać typy RANGED_VALUE i SHORT_TEXT oraz źródło następnego spotkania może obsługiwać typy SHORT_TEXT i LONG_TEXT.
  • Możesz wybrać, ile widżetów ma być uwzględnionych na tarczy zegarka oraz typy widżetów , które mają być obsługiwane. Na przykład widżet 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.

Aby dowiedzieć się więcej o różnych typach widżetów i polach obsługiwanych przez każdy typ, przeczytaj artykuł Typy widżetów.