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 元素还可以包含以下内部元素