WatchFace

<ph type="x-smartling-placeholder"></ph>

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