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

• BitmapFonts
• Metadata
• UserConfigurations