Tarcza zegarka

Element główny każdego pliku watchface.xml. Zawiera on informacje o elementach, które powinny wyświetlać się na podglądzie tarczy zegarka, gdy użytkownik wybierze tarczę, której ma używać na urządzeniu z Wear OS.

Wprowadzona w Wear OS 4.

Składnia

<WatchFace width="positive-integer" height="positive-integer"
           clipShape="NONE | CIRCLE | RECTANGLE" cornerRadiusX="float"
           cornerRadiusY="float">
  <!-- Only the required inner element is shown here. -->
  <Scene>
  </Scene>
</WatchFace>

Atrybuty

Element WatchFace musi zawierać te atrybuty:

width
Szerokość ekranu wizualnego, na którym rysowane są komponenty tarczy zegarka, wyrażona w pikselach. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają ustawiony rozmiar i pozycję względem rozmiaru ekranu. Pamiętaj, że rozmiar ekranu wizualnego może mieć inny rozmiar niż rozdzielczość wyświetlacza fizycznego urządzenia z Wear OS.
height
Wysokość ekranu wizualnego, na którym rysowane są komponenty tarczy zegarka, wyrażona w pikselach. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają ustawiony rozmiar i pozycję względem rozmiaru ekranu. Rozmiar ekranu wizualnego może mieć inny rozmiar niż rozdzielczość wyświetlacza fizycznego urządzenia z Wear OS.

Element WatchFace może też zawierać te atrybuty:

clipShape

Kształt ekranu wizualnego, który ma być używany w podglądzie tarczy zegarka. Jeśli użyjesz wartości CIRCLE, elementy w rogach ekranu mogą zostać częściowo obcięte.

Wartość domyślna to CIRCLE.

cornerRadiusX

Długość połowy osi poziomej elipsy, która tworzy zaokrąglone rogi. Użyj jej razem z polem cornerRadiusY, by uzyskać efekt zaokrąglonego prostokąta.

Ta wartość nie działa, chyba że określisz clipShape o wartości RECTANGLE.

cornerRadiusY

Długość połowy osi pionowej elipsy, która tworzy zaokrąglone narożniki. Użyj tej wartości razem z cornerRadiusY, aby uzyskać efekt zaokrąglonego prostokąta.

Ta wartość nie działa, chyba że określisz clipShape o wartości RECTANGLE.

Elementy wewnętrzne

Element WatchFace musi zawierać co najmniej 1 element wewnętrzny Scene.

Element WatchFace może też zawierać te elementy wewnętrzne: