หน้าปัด

องค์ประกอบรูทของไฟล์ 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 อย่างน้อย 1 รายการ

องค์ประกอบ WatchFace อาจมีองค์ประกอบภายในต่อไปนี้ด้วย