手表表盘

每个 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 元素必须包含以下属性

宽度
以像素为单位绘制手表表盘组件的视觉屏幕的宽度。所有子几何元素（例如形状和复杂功能）的大小和位置都相对于视觉屏幕大小设置。请注意，视觉屏幕的大小可能与物理 Wear OS 设备的显示分辨率不同。
高度
以像素为单位绘制手表表盘组件的视觉屏幕的高度。所有子几何元素（例如形状和复杂功能）的大小和位置都相对于视觉屏幕大小设置。请注意，视觉屏幕的大小可能与物理 Wear OS 设备的显示分辨率不同。

WatchFace 元素还可以包含以下属性

剪辑形状

要用于手表表盘预览的视觉屏幕的形状。如果您使用 CIRCLE 值，则角落附近的元素可能会部分被切掉。

默认值为 CIRCLE。

圆角 X

椭圆水平轴的一半长度，用于创建圆角。将此值与 cornerRadiusY 一起使用，以创建圆角矩形效果。

除非您指定 clipShape 为 RECTANGLE，否则此值无效。

圆角 Y

椭圆垂直轴的一半长度，用于创建圆角。将此值与 cornerRadiusY 一起使用，以创建圆角矩形效果。

除非您指定 clipShape 为 RECTANGLE，否则此值无效。

内部元素

WatchFace 元素必须包含至少一个 Scene 内部元素。

WatchFace 元素还可以包含以下内部元素