WatchFace

Elemen root setiap file watchface.xml. Format ini berisi informasi tentang elemen yang akan muncul dalam pratinjau tampilan jam saat pengguna memilih tampilan jam yang akan digunakan di perangkat Wear OS.

Diperkenalkan di Wear OS 4.

Sintaksis

<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>

Atribut

Elemen WatchFace harus berisi atribut berikut:

width
Lebar layar visual yang digunakan untuk menggambar komponen tampilan jam, dalam piksel. Semua elemen geometri turunan, seperti bentuk dan detail, memiliki ukuran dan posisinya yang relatif terhadap ukuran layar visual. Perhatikan bahwa layar visual mungkin memiliki ukuran yang berbeda dengan resolusi tampilan perangkat Wear OS fisik.
height
Tinggi layar visual yang digunakan untuk menggambar komponen tampilan jam, dalam piksel. Semua elemen geometri turunan, seperti bentuk dan detail, memiliki ukuran dan posisinya yang relatif terhadap ukuran layar visual. Perhatikan bahwa layar visual mungkin memiliki ukuran yang berbeda dengan resolusi tampilan perangkat Wear OS fisik.

Elemen WatchFace juga dapat berisi atribut berikut:

clipShape

Bentuk layar visual yang akan digunakan untuk pratinjau tampilan jam. Jika Anda menggunakan nilai CIRCLE, kemungkinan elemen di dekat sudut akan terpotong sebagian.

Nilai default-nya adalah CIRCLE.

cornerRadiusX

Panjang setengah sumbu horizontal elips, yang membuat sudut membulat. Gunakan nilai ini, beserta cornerRadiusY, untuk membuat efek persegi panjang membulat.

Nilai ini tidak berpengaruh, kecuali jika Anda menentukan clipShape dari RECTANGLE.

cornerRadiusY

Panjang setengah sumbu vertikal elips, yang membentuk sudut membulat. Gunakan nilai ini, beserta cornerRadiusY, untuk membuat efek persegi panjang membulat.

Nilai ini tidak berpengaruh, kecuali jika Anda menentukan clipShape dari RECTANGLE.

Elemen dalam

Elemen WatchFace harus berisi setidaknya satu elemen dalam Scene.

Elemen WatchFace juga dapat berisi elemen dalam berikut: