Tarcza zegarka

Element główny każdego pliku watchface.xml. Zawiera on informacje na temat: Elementy, które powinny pojawić się na podglądzie tarczy zegarka po wybraniu przez użytkownika tarczy zegarka, której ma używać na urządzeniach 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, na którym rysowane są komponenty tarczy zegarka, w calach pikseli. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają ich rozmiarów i pozycji względem rozmiaru ekranu. Pamiętaj, że parametr ekran może mieć inny rozmiar niż rozdzielczość na urządzeniu z Wear OS.
height
Wysokość ekranu, na którym rysowane są komponenty tarczy zegarka, w calach pikseli. Wszystkie podrzędne elementy geometryczne, takie jak kształty i widżety, mają ich rozmiarów i pozycji względem rozmiaru ekranu. Pamiętaj, że parametr ekran może mieć inny rozmiar niż rozdzielczość fizyczne urządzenie 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żywasz wartość CIRCLE, możliwe, że elementy w rogach ekranu stają się częściowo odcięcie.

Wartość domyślna to CIRCLE.

cornerRadiusX

Długość połowy osi poziomej elipsy, która tworzy zaokrąglenie w rogach ekranu. Użyj tej wartości razem z parametrem cornerRadiusY, aby utworzyć 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 utworzyć zaokrąglony prostokąt efektu.

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:

. .