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
nichtRECTANGLE
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
nichtRECTANGLE
angeben.
Innere Elemente
Das WatchFace
-Element muss mindestens ein inneres Scene
-Element enthalten.
Das WatchFace
-Element kann auch die folgenden Elemente im Inneren enthalten:
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- RoundRectangle
- BitmapFonts
- Zusatzfunktion