Özellik Alanı

Özellik Alanı, saat kadranında kullanıcının Özellik (Komplikasyon) ekleyebileceği bir alandır. Komplikasyon Slotları, özelliğin farklı Özellik Türleri ve farklı kadran modlarında nasıl oluşturulduğunu tanımlayan Komplikasyon öğeleri içerir.

Wear OS 4'te kullanıma sunuldu.

Sözdizimi

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Özellikler

ComplicationSlot aşağıdaki özelliklere sahiptir:

Gerekli özellikler

Aşağıdaki özellikler gereklidir:

x, y, width, height
Öğenin boyutunu ve konumunu belirten tam sayı koleksiyonu.
slotId
Alan için benzersiz bir sayısal tanımlayıcıdır.
supportedTypes
Alanı doldurabilecek, desteklenen Komplikasyon Türlerinin bir listesi. Desteklenen değerler: SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE ve EMPTY. Birden fazla komplikasyon türü boşlukla ayrılarak desteklenebilir (örneğin, SHORT_TEXT RANGED_VALUE).

İsteğe bağlı özellikler

Aşağıdaki özellikler isteğe bağlıdır:

pivotX, pivotY
Öğenin etrafında döndüğü iki boyutlu pivot nokta. Her iki değer de $ [0, 1] $ aralığına sığacak şekilde ölçeklendirilmiş kayan noktalı sayılardır.
angle
Öğenin, dönme noktası çevresinde saat yönünde döndürülmesi gereken derece sayısı.
alpha
Bu öğenin sahip olması gereken şeffaflık düzeyini ayarlayın. 0 değeri, öğenin tamamen şeffaf olması gerektiğini belirtir. 255 değeri, öğenin tamamen opak olması gerektiğini belirtir.
scaleX
Bu öğeye uygulanacak yatay ölçeklendirme faktörü.
scaleY
Bu öğeye uygulanacak dikey ölçeklendirme faktörü.
tintColor
Öğeye bir ton renk filtresi uygulayın. Rengi, ARGB biçimini (#ff000000 = opak siyah) veya RGB biçimini (#000000 = siyah) kullanarak belirtmeniz gerekir.
displayName
Komplikasyon slotu için yerelleştirilmiş ada karşılık gelen ve kadran düzenleyicide gösterilen kaynak kimliği.
isCustomizable
Kullanıcının, kadran düzenleyicide bu slotun sağlayıcısını değiştirip değiştiremeyeceğini belirler. Varsayılan olarak TRUE değerine ayarlanır.

İç öğeler

ComplicationSlot öğesi, tam olarak bir Sınırlama Alanı öğesi içermelidir.

Bir ComplicationSlot öğesi, desteklenen Özellik Türü başına en az bir Komplikasyon öğesi içermelidir. ComplicationSlot öğesi, Variant öğeleriyle görünümün değiştirilmesini desteklemek için isteğe bağlı olarak daha fazla Complication öğesi içerebilir.

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