Tarcza zegarka

Element główny każdego pliku watchface.xml. Zawiera informacje o tym, jakie elementy powinny być widoczne w podglądzie tarczy zegarka, gdy użytkownicy wybierają tarczę, której chcą użyć na swoich urządzeniach z Wear OS.

Wprowadzone 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 są rysowane komponenty tarczy zegarka, w pikselach. Rozmiary i położenie wszystkich podrzędnych elementów geometrycznych, takich jak kształty i komplikacje, są określane w odniesieniu do rozmiaru ekranu wizualnego. Pamiętaj, że ekran wizualny może mieć inny rozmiar niż rozdzielczość wyświetlacza fizycznego urządzenia z Wear OS.
height
Wysokość ekranu wizualnego, na którym są rysowane komponenty tarczy zegarka, w pikselach. Rozmiary i położenie wszystkich podrzędnych elementów geometrycznych, takich jak kształty i komplikacje, są określane w odniesieniu do rozmiaru ekranu wizualnego. Pamiętaj, że ekran wizualny 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 do podglądu tarczy zegarka. Jeśli użyjesz wartości CIRCLE, elementy w pobliżu rogów mogą być częściowo przycięte.

Wartość domyślna to CIRCLE.

cornerRadiusX

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

Ta wartość nie ma żadnego efektu, dopóki nie określisz wartości clipShape RECTANGLE.

cornerRadiusY

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

Ta wartość nie ma żadnego efektu, dopóki nie określisz wartości clipShape 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: