WatchFace

O elemento raiz de cada arquivo watchface.xml. Ele contém informações sobre os elementos que vão aparecer na prévia do mostrador do relógio quando os usuários escolherem qual mostrador usar nos dispositivos Wear OS.

Introduzido no Wear OS 4.

Sintaxe

<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

O elemento WatchFace precisa conter os seguintes atributos:

width
Largura da tela visual em que os componentes do mostrador do relógio são desenhados, em pixels. Todos os elementos geométricos filhos, como formas e complicações, têm tamanhos e posições definidos em relação ao tamanho da tela visual. A tela visual pode ter um tamanho diferente da resolução da tela de um dispositivo físico do Wear OS.
height
Altura da tela visual em que os componentes do mostrador do relógio são desenhados, em pixels. Todos os elementos geométricos filhos, como formas e complicações, têm tamanhos e posições definidos em relação ao tamanho da tela visual. A tela visual pode ter um tamanho diferente da resolução da tela de um dispositivo físico do Wear OS.

O elemento WatchFace também pode conter os seguintes atributos:

clipShape

O formato da tela que será usado na prévia do mostrador do relógio. Se você usar um valor de CIRCLE, é provável que os elementos próximos aos cantos sejam parcialmente cortados.

O valor padrão é CIRCLE.

cornerRadiusX

O comprimento da metade do eixo horizontal de uma elipse, que cria cantos arredondados. Use esse valor com cornerRadiusY para criar um efeito de retângulo arredondado.

Esse valor não terá efeito a menos que você especifique um clipShape de RECTANGLE.

cornerRadiusY

O comprimento da metade do eixo vertical de uma elipse, que cria cantos arredondados. Use esse valor com cornerRadiusY para criar um efeito de retângulo arredondado.

Esse valor não terá efeito a menos que você especifique um clipShape de RECTANGLE.

Elementos internos

O elemento WatchFace precisa conter pelo menos um elemento interno Scene.

O elemento WatchFace também pode conter os seguintes elementos internos: