WatchFace

Корневой элемент каждого файла watchface.xml . Он содержит информацию об элементах, которые должны отображаться в предварительном просмотре циферблата, когда пользователи выбирают, какой циферблат использовать на своих устройствах с Wear OS.

Представлено в Wear OS 4.

Синтаксис 

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

Атрибуты

Элемент WatchFace должен содержать следующие атрибуты:

width
Ширина визуального экрана, на котором отображаются компоненты циферблата, в пикселях. Размер и положение всех дочерних геометрических элементов, таких как формы и сложности, задаются относительно размера визуального экрана. Обратите внимание, что размер визуального экрана может отличаться от разрешения экрана физического устройства Wear OS.
height
Высота визуального экрана, на котором отображаются компоненты циферблата, в пикселях. Размер и положение всех дочерних геометрических элементов, таких как формы и сложности, задаются относительно размера визуального экрана. Обратите внимание, что размер визуального экрана может отличаться от разрешения экрана физического устройства Wear OS.

Элемент WatchFace также может содержать следующие атрибуты:

clipShape

Форма визуального экрана, используемая для предварительного просмотра циферблата. Если вы используете значение CIRCLE , вполне вероятно, что элементы вблизи углов будут частично обрезаны.

Значение по умолчанию — CIRCLE .

cornerRadiusX

Длина половины горизонтальной оси эллипса, которая создает закругленные углы. Используйте это значение вместе с cornerRadiusY для создания эффекта закругленного прямоугольника.

Это значение не имеет никакого эффекта, если вы не укажете clipShape RECTANGLE .

cornerRadiusY

Длина половины вертикальной оси эллипса, которая создает закругленные углы. Используйте это значение вместе с cornerRadiusY для создания эффекта закругленного прямоугольника.

Это значение не имеет никакого эффекта, если вы не укажете clipShape RECTANGLE .

Внутренние элементы

Элемент WatchFace должен содержать хотя бы один внутренний элемент Scene .

Элемент WatchFace также может содержать следующие внутренние элементы:

{% дословно %} {% дословно %} {% дословно %} {% дословно %}