WatchFace

Es el elemento raíz de cada archivo watchface.xml. Contiene información sobre los elementos que deben aparecer en la vista previa de la cara de reloj cuando los usuarios eligen qué cara de reloj usarán en sus dispositivos Wear OS.

Se introdujo en Wear OS 4.

Sintaxis

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

Atributos

El elemento WatchFace debe contener los siguientes atributos:

width
Ancho, en píxeles, de la pantalla visual en la que se dibujan los componentes de la cara de reloj. El tamaño y la posición de todos los elementos geométricos secundarios, como las formas y las complicaciones, se relacionan con el tamaño de la pantalla visual. Ten en cuenta que la pantalla visual puede tener un tamaño diferente al de la resolución de un dispositivo Wear OS físico.
height
Altura, en píxeles, de la pantalla visual en la que se dibujan los componentes de la cara de reloj. El tamaño y la posición de todos los elementos geométricos secundarios, como las formas y las complicaciones, se relacionan con el tamaño de la pantalla visual. Ten en cuenta que la pantalla visual puede tener un tamaño diferente al de la resolución de un dispositivo Wear OS físico.

El elemento WatchFace también puede contener los siguientes atributos:

clipShape

Es la forma de la pantalla visual que se usará para la vista previa de la cara de reloj. Si usas un valor de CIRCLE, es probable que los elementos cercanos a las esquinas se corten parcialmente.

El valor predeterminado es CIRCLE.

cornerRadiusX

La longitud de la mitad del eje horizontal de una elipse, que crea esquinas redondeadas. Usa este valor, junto con cornerRadiusY, para crear un efecto de rectángulo redondeado.

Este valor no tiene efecto, a menos que especifiques una clipShape de RECTANGLE.

cornerRadiusY

La longitud de la mitad del eje vertical de una elipse, que crea esquinas redondeadas. Usa este valor, junto con cornerRadiusY, para crear un efecto de rectángulo redondeado.

Este valor no tiene efecto, a menos que especifiques una clipShape de RECTANGLE.

Elementos internos

El elemento WatchFace debe contener al menos un elemento interno Scene.

El elemento WatchFace también puede contener los siguientes elementos internos: