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，即可建立圓角矩形效果。

必須指定 RECTANGLE 的 clipShape，這個值才有作用。

cornerRadiusY

橢圓形垂直軸長的一半，會建立圓角。使用這個值搭配 cornerRadiusY，即可建立圓角矩形效果。

必須指定 RECTANGLE 的 clipShape，這個值才有作用。

內部元素

WatchFace 元素必須包含至少一個 Scene 內部元素。

WatchFace 元素也可包含下列內部元素：

• BitmapFonts
• Metadata
• UserConfigurations