Kadrana özellik ekleme

Kadran özelliği, bir veri kaynağından veri gösterir. Saat Kadranı Formatı'nı kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Bu sayede kadranlarınız, verileri almak için koda gerek kalmadan, günün ilerleyen saatlerinde bilgi gösterebilir.

Saat Kadranı Formatı'nı kullanma

Complication öğesi, tek bir kadranda sekiz adede kadar özellik tanımlamanıza olanak sağlar. Bu öğe, her bir özelliğin kadranda nerede görüneceğini de tanımlamanızı sağlar.

Daha fazla bilgi için GitHub'daki WatchFaceFormat örneğine göz atın.

Türler ve alanlar

Aşağıdaki tabloda ComplicationData nesnesinin türleri ve alanları açıklanmaktadır. Kadran, bir özellik türü için geçersiz olan bir alan isterse bu alan için varsayılan bir değer döndürülür. Örneğin, bir kadran SHORT_TEXT türünde bir LONG_TEXT alanına erişmeye çalışırsa LONG_TEXT alanı için varsayılan değer olan null döndürülür. İsteğe bağlı alanların gösterilmesinin garanti edilmediğini unutmayın.





Tür Zorunlu alanlar İsteğe bağlı alanlar Notlar
SHORT_TEXT Kısa metin Simge
Yerleşik koruma simgesi
Kısa başlık
İçerik açıklaması

 İkisinden biri veya her ikisi de sağlanmışsa yalnızca bir simge veya kısa başlık gösterir.
MONOCHROMATIC_IMAGE Tek renkli resim
 Yerleşik koruma simgesi
İçerik açıklaması

 Metin gerekli olmadığında kullanılır. Simgenin tek renkli olması beklenir ve kadranda tonlama yapılabilir.
RANGED_VALUE Değer
Minimum değer
Maksimum değer
 Tek renkli resim
Yerleşik koruma simgesi
Kısa metin
Kısa başlık
Renk rampası
Dinamik değer
İçerik açıklaması

 Kendi ilerleme çubuğunuzu çizmek istiyorsanız ComplicationDrawable sınıfının sağladığı ilerleme çubuğunu gizlemek için isRangedValueProgressHidden() yöntemini kullanabilirsiniz.
GOAL_PROGRESS Değer
Target value (Hedef değer)
 Tek renkli resim
Yerleşik koruma simgesi
Kısa metin
Kısa başlık
Renk rampası
Dinamik değer
İçerik açıklaması

 GOAL_PROGRESS, değerin sıfırdan başladığı ve Hedef değeri aşmasına izin verilen adım sayısı gibi şeyler için tasarlanmıştır.
LONG_TEXT Uzun metin
 Uzun başlık
Tek renkli resim
Yerleşik koruma simgesi
Küçük resim
İçerik açıklaması
 Sağlanmışsa uzun başlığı gösterir.
SMALL_IMAGE Küçük resim
 İçerik açıklaması
 Küçük bir resmin iki stilden biri vardır: fotoğraf stili veya simge stili. Fotoğraf stili, alanı doldurması beklenen ve kırpılabilir. Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir. Görüntü değişkenliği, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmek için uygun olmayan bir görüntüye neden olabilir. Yanma koruması veya düşük bitli ambiyans modu etkinleştirildiğinde kadran, güvenli olduğu için yanma korumasını küçük resmi kullanabilir. Aksi takdirde, kadran uygunluğu belirlemek zor olduğundan resim gösterilmez.
LARGE_IMAGE Büyük resim
 İçerik açıklaması
 Bu resmin, kadranı dolduracak kadar büyük olması beklenir. Görüntü değişkenliği, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmek için uygun olmayan bir görüntüye neden olabilir. Kadranın görüntülemeye uygun olup olmadığını belirlemesi zor olduğundan, yanma koruması veya düşük bitli ortam etkin olduğunda kadran, ambiyans modunda resim göstermez.
WEIGHTED_ELEMENTS Öğe listesi
 Tek renkli resim
Yerleşik koruma simgesi
Kısa metin
Kısa başlık
İçerik açıklaması
 Her öğe, bir renk ve ağırlıktan (sıfırdan büyük) oluşur. Oluşturulan öğenin boyutu, ağırlığıyla orantılı olmalıdır. Ağırlıkların belirli bir değerle toplanması gerekmez. Kadranların WEIGHTED_ELEMENTS öğesinin yeniden renklendirilmesine izin verildiğini unutmayın.

Aşağıdaki tabloda, herhangi bir özellik alanı için gönderilebilecek boş verilere yönelik özellik türleri açıklanmaktadır. Bu türlerde alan bulunmaz ve desteklenen türler listesine eklenmeleri gerekmez. Bu türler, kadranların aşağıdaki üç durumda ayırt edilmesini sağlar:

  • Kaynak seçilmedi
  • Kullanıcı bir alan için "boş" seçeneğini belirledi
  • Bir kaynakta gönderilecek veri yok

Kaynaklar güncelleme isteklerine yanıt olarak TYPE_EMPTY gönderemez. Bunun yerine TYPE_NO_DATA gönderin.

Özellik türü Açıklama
TYPE_NOT_CONFIGURED Bir özellik etkinleştiğinde ancak kullanıcı bir kaynak seçmediğinde ve varsayılan ayarlanmadığında sistem tarafından gönderilir.

Kaynak tarafından gönderilemez.

TYPE_EMPTY Bir özellik etkinleştirildiğinde ve kullanıcı bir kaynak yerine "boş" seçeneğini belirlediğinde veya kadran hiç kaynak seçmediğinde ve bu özellik türünü varsayılan olarak seçtiğinde sistem tarafından gönderilir.

Kaynak tarafından gönderilemez.

TYPE_NO_DATA Kaynaktan gerçek veriler alınmadan önce özelliği temizlemek için kaynağı olan bir özellik etkinleştirildiğinde sistem tarafından gönderilir.

Gönderilecek gerçek veri yoksa kaynaklar tarafından gönderilebilir.

Çoğu veri kaynağı, Saat Kadranı Formatı gerektirir

Wear OS'in yeni sürümlerinde kadran komplikasyonlarının görünümünü korumak için Saat Kadranı Formatı'nı kullanmanız gerekir. Kadranınız bunun yerine Jetpack Saat Kadranı kitaplığını veya Giyilebilir Cihaz Destek Kitaplığı'nı kullanıyorsa Wear OS'in yeni sürümleri, kadran komplikasyonlarında çoğu veri kaynağından veri göstermez.

Saat Kadranı Formatı'nı kullanmayan kadranlardaki komplikasyonların görünümünü tamamen korumak için kadranların, komplikasyon alanlarında aşağıdaki veri kaynaklarından birini kullanması gerekir:

Cihaz üreticisine bağlı olarak, Saat Kadranı Formatı'nı kullanmayan kadranlarda birkaç ek komplikasyon kaynağı görülebilir.