WatchFace

Élément racine de chaque fichier watchface.xml. Il contient des informations sur les éléments à afficher dans l'aperçu du cadran lorsque les utilisateurs choisissent le cadran destiné à leurs appareils Wear OS.

Introduit dans Wear OS 4.

Syntaxe

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

Attributs

L'élément WatchFace doit contenir les attributs suivants :

width
Largeur de l'écran visuel sur lequel les composants du cadran sont dessinés, en pixels. La taille et la position de tous les éléments géométriques enfants, comme les formes et les complications, sont définies par rapport à la taille de l'écran. Notez que la taille de l'écran peut être différente de celle d'un appareil Wear OS physique.
height
Hauteur de l'écran visuel sur lequel les composants du cadran sont dessinés, en pixels. La taille et la position de tous les éléments géométriques enfants, comme les formes et les complications, sont définies par rapport à la taille de l'écran. Notez que la taille de l'écran peut être différente de celle d'un appareil Wear OS physique.

L'élément WatchFace peut aussi contenir les attributs suivants :

clipShape

Forme de l'écran visuel à utiliser pour l'aperçu du cadran. Si vous utilisez la valeur CIRCLE, il est probable que les éléments situés à proximité des angles soient partiellement tronqués.

La valeur par défaut est CIRCLE.

cornerRadiusX

Longueur de la moitié de l'axe horizontal d'une ellipse, ce qui crée des coins arrondis. Utilisez cette valeur avec cornerRadiusY pour créer un effet de rectangle arrondi.

Cette valeur n'a aucun effet, sauf si vous spécifiez RECTANGLE comme clipShape.

cornerRadiusY

Longueur de la moitié de l'axe vertical d'une ellipse, ce qui crée des coins arrondis. Utilisez cette valeur avec cornerRadiusY pour créer un effet de rectangle arrondi.

Cette valeur n'a aucun effet, sauf si vous spécifiez RECTANGLE comme clipShape.

Éléments internes

L'élément WatchFace doit contenir au moins un élément interne Scene.

L'élément WatchFace peut également contenir les éléments internes suivants :