Zifferblatt

Das Stammelement jeder watchface.xml-Datei. Es enthält Informationen zu den Elementen, die in der Zifferblattvorschau angezeigt werden sollen, wenn Nutzer das Zifferblatt für ihre Wear OS-Geräte auswählen.

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

Merkmale

Das WatchFace-Element muss die folgenden Attribute enthalten:

width
Breite des Bildschirms, auf dem Zifferblattkomponenten gezeichnet werden, in Pixeln. Für alle untergeordneten geometrischen Elemente wie 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 hat.
height
Höhe des visuellen Bildschirms in Pixeln, auf dem Zifferblattkomponenten gezeichnet werden. Für alle untergeordneten geometrischen Elemente wie 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 hat.

Das Element WatchFace kann auch die folgenden Attribute enthalten:

clipShape

Die Form des visuellen Bildschirms, die für die Zifferblattvorschau verwendet werden soll. Wenn Sie den Wert CIRCLE verwenden, ist es wahrscheinlich, dass Elemente in der Nähe der Ecken teilweise abgeschnitten werden.

Der Standardwert ist CIRCLE.

cornerRadiusX

Die Länge der halben horizontalen Achse einer Ellipse, durch die runde Ecken entstehen. Verwenden Sie diesen Wert zusammen mit cornerRadiusY, um einen abgerundeten Rechteck-Effekt zu erzeugen.

Dieser Wert hat keine Auswirkungen, es sei denn, Sie geben für clipShape den Wert RECTANGLE an.

cornerRadiusY

Die Länge der Hälfte der vertikalen Achse einer Ellipse, durch die abgerundete Ecken entstehen. Verwenden Sie diesen Wert zusammen mit cornerRadiusY, um einen Effekt mit abgerundetem Rechteck zu erzeugen.

Dieser Wert hat keine Auswirkungen, es sei denn, Sie geben für clipShape den Wert RECTANGLE an.

Innere Elemente

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

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