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ściRECTANGLE
.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ściRECTANGLE
.
Elementy wewnętrzne
Element WatchFace
musi zawierać co najmniej 1 element wewnętrzny Scene
.
Element WatchFace
może też zawierać te elementy wewnętrzne:
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- Roundprostokąt
- BitmapFonts
- ComplicationSlot.