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.

Eingeführt in Wear OS 4.

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>

Merkmale

Das WatchFace-Element muss die folgenden Attribute enthalten:

width
Breite des visuellen Bildschirms in Pixeln, auf dem Zifferblattkomponenten gezeichnet werden. Bei allen untergeordneten geometrischen Elementen, z. B. Formen und Zusatzfunktionen, werden Größen und Positionen relativ zur visuellen Bildschirmgröße festgelegt. Beachte, dass der visuelle Bildschirm möglicherweise eine andere Größe als die Bildschirmauflösung eines physischen Wear OS-Geräts haben kann.
height
Höhe in Pixeln des visuellen Bildschirms, auf dem Zifferblattkomponenten gezeichnet werden. Bei allen untergeordneten geometrischen Elementen, z. B. Formen und Zusatzfunktionen, werden Größen und Positionen relativ zur visuellen Bildschirmgröße festgelegt. Beachte, dass der visuelle Bildschirm möglicherweise eine andere Größe als die Bildschirmauflösung eines physischen Wear OS-Geräts haben kann.

Das WatchFace-Element kann auch die folgenden Attribute enthalten:

clipShape

Die Form des visuellen Bildschirms, der für die Vorschau des Zifferblatts verwendet werden soll. Wenn Sie den Wert CIRCLE verwenden, sind 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 Rechteck-Effekt zu erzeugen.

Dieser Wert hat keine Auswirkungen, sofern Sie für clipShape nicht RECTANGLE angeben.

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

Dieser Wert hat keine Auswirkungen, sofern Sie für clipShape nicht RECTANGLE angeben.

Innere Elemente

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

Das WatchFace-Element kann auch die folgenden Elemente im Inneren enthalten: