Kadran

Her watchface.xml dosyasının kök öğesidir. Kullanıcılar Wear OS cihazlarında hangi kadranların kullanılacağını seçtiğinde kadran önizlemesinde görünmesi gereken öğelerle ilgili bilgiler içerir.

Wear OS 4'te kullanıma sunuldu.

Sözdizimi

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

Özellikler

WatchFace öğesi aşağıdaki özellikleri içermelidir:

width
Kadran bileşenlerinin çizildiği görsel ekranın piksel cinsinden genişliği. Şekiller ve komplikasyonlar gibi alt geometrik öğelerin tamamının boyutları ve konumları görsel ekran boyutuna göre ayarlanır. Görsel ekranın, fiziksel bir Wear OS cihazın ekran çözünürlüğünden farklı bir boyutta olabileceğini unutmayın.
height
Kadran bileşenlerinin çizildiği görsel ekranın piksel cinsinden yüksekliği. Şekiller ve komplikasyonlar gibi alt geometrik öğelerin tamamının boyutları ve konumları görsel ekran boyutuna göre ayarlanır. Görsel ekranın, fiziksel bir Wear OS cihazın ekran çözünürlüğünden farklı bir boyutta olabileceğini unutmayın.

WatchFace öğesi, aşağıdaki özellikleri de içerebilir:

clipShape

Kadran önizlemesi için kullanılacak görsel ekranın şekli. CIRCLE değeri kullanırsanız köşelerin yakınındaki öğeler kısmen kesilmiş olabilir.

Varsayılan değer: CIRCLE.

cornerRadiusX

Bir elipsin yatay ekseninin, yuvarlak köşeler oluşturan yarısının uzunluğu. Yuvarlak dikdörtgen efekti oluşturmak için cornerRadiusY ile birlikte bu değeri kullanın.

Bir RECTANGLE clipShape belirtmediğiniz sürece bu değerin bir etkisi olmaz.

cornerRadiusY

Bir elipsin yuvarlak köşeler oluşturan dikey ekseninin yarısının uzunluğu. Yuvarlak dikdörtgen efekti oluşturmak için cornerRadiusY ile birlikte bu değeri kullanın.

Bir RECTANGLE clipShape belirtmediğiniz sürece bu değerin bir etkisi olmaz.

İç öğeler

WatchFace öğesi, en az bir Scene iç öğesi içermelidir.

WatchFace öğesi, aşağıdaki iç öğeleri de içerebilir: