Tarcza zegarka

Element główny każdego pliku watchface.xml. Zawiera on informacje o elementach, które powinny wyświetlać się w podglądzie tarczy zegarka, gdy użytkownik wybiera tarczę, która ma być używana 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 są rysowane komponenty tarczy zegarka, podana w pikselach. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają rozmiar i położenie w odniesieniu do rozmiaru ekranu wizualnego. Pamiętaj, że rozmiar ekranu wizualnego może różnić się od rozdzielczości wyświetlacza fizycznego urządzenia z Wear OS.
height
Wysokość ekranu (w pikselach), na którym są narysowane komponenty tarczy zegarka. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają rozmiar i położenie w odniesieniu do rozmiaru ekranu wizualnego. Pamiętaj, że rozmiar ekranu wizualnego może różnić się od rozdzielczości wyświetlacza fizycznego urządzenia z Wear OS.

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

clipShape

Kształt ekranu wizualnego używanego do wyświetlania podglądu tarczy zegarka. Jeśli użyjesz wartości CIRCLE, możliwe, że elementy w pobliżu narożników zostaną częściowo obcię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 razem z atrybutem cornerRadiusY, aby uzyskać efekt zaokrąglonego prostokąta.

Ta wartość nie zadział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 zadział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: