Zifferblatt

Das Stammelement jeder watchface.xml-Datei. Sie enthält Informationen zu den Elementen, die in der Zifferblattvorschau angezeigt werden sollen, wenn Nutzer auswählen, welches Zifferblatt sie auf ihren Wear OS-Geräten verwenden möchten.

In Wear OS 4 eingeführt.

Syntax

<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>

Attribute

Das WatchFace-Element muss die folgenden Attribute enthalten:

width
Breite des visuellen Bildschirms, auf dem Zifferblattkomponenten dargestellt werden, in Pixeln. Die Größe und Position aller untergeordneten geometrischen Elemente wie Formen und Zusatzfunktionen werden relativ zur visuellen Bildschirmgröße festgelegt. Beachten Sie, dass der virtuelle Bildschirm eine andere Größe als die Bildschirmauflösung eines physischen Wear OS-Geräts haben kann.
height
Höhe des visuellen Displays, auf dem die Zifferblattkomponenten dargestellt werden, in Pixeln. Die Größe und Position aller untergeordneten geometrischen Elemente wie Formen und Zusatzfunktionen werden relativ zur visuellen Bildschirmgröße festgelegt. Beachten Sie, dass der virtuelle Bildschirm eine andere Größe als die Displayauflösung eines physischen Wear OS-Geräts haben kann.

Das WatchFace-Element kann auch die folgenden Attribute enthalten:

clipShape

Die Form des visuellen Bildschirms, die für die Vorschau des Zifferblatts verwendet werden soll. Wenn Sie den Wert CIRCLE verwenden, werden Elemente in den Ecken wahrscheinlich teilweise abgeschnitten.

Der Standardwert ist CIRCLE.

cornerRadiusX

Die Länge der Hälfte der horizontalen Achse einer Ellipse, wodurch runde Ecken entstehen. Verwenden Sie diesen Wert zusammen mit cornerRadiusY, um einen abgerundeten Rechteckeffekt zu erzielen.

Dieser Wert hat keine Auswirkungen, es sei denn, Sie geben RECTANGLE als clipShape an.

cornerRadiusY

Die Länge der Hälfte der vertikalen Achse einer Ellipse, wodurch runde Ecken entstehen. Verwenden Sie diesen Wert zusammen mit cornerRadiusY, um einen abgerundeten Rechteckeffekt zu erzielen.

Dieser Wert hat keine Auswirkungen, es sei denn, Sie geben RECTANGLE als clipShape an.

Innere Elemente

Das WatchFace-Element muss mindestens ein inneres Scene-Element enthalten.

Das WatchFace-Element kann auch die folgenden inneren Elemente enthalten: