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ı biçimini kullanma

Complication öğesi, tek bir kadranda sekiz adede kadar komplikasyon tanımlamanıza olanak tanır. Öğe, her komplikasyonun kadran üzerinde nerede görüneceğini de tanımlamanıza olanak tanır.

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ündeki bir LONG_TEXT alanına erişmeye çalışırsa LONG_TEXT alanının varsayılan değeri olan null döndürülür. İsteğe bağlı alanların gösterileceği garanti edilmez.





Tür Zorunlu alanlar İsteğe bağlı alanlar Notlar
SHORT_TEXT Kısa metin Simge
Yanma koruması 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
 Yanma koruması simgesi
İçerik açıklaması

 Metin gerekmediğinde 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
Yanma koruması simgesi
Kısa metin
Kısa başlık
Renk rampası
Dinamik değer
İçerik açıklaması

 Kendi ilerleme çubuğunuzu çizmek istiyorsanız sınıfı tarafından sağlanan ilerleme çubuğunu gizlemek için isRangedValueProgressHidden() yöntemini kullanabilirsiniz.ComplicationDrawable
GOAL_PROGRESS Değer
Hedef değer
 Tek renkli resim
Yanma koruması 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ğerin üzerine çıkılmasına izin verilen adım sayısı gibi metrikler 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ı
 Uzun başlık sağlanmışsa uzun başlığı gösterir.
SMALL_IMAGE Küçük resim
 İçerik açıklaması
 Küçük resimler iki tarzdan birine sahiptir: fotoğraf tarzı veya simge tarzı. Fotoğraf stili, alanın doldurulmasını beklediğiniz ve kırpılabilen bir fotoğraf Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir. Görüntü değişkenliği, yanmaya karşı korumalı veya düşük bitlik ambiyans modu olan cihazlarda ambiyans modunda görüntüleme için uygun olmayan bir görüntüye neden olabilir. Yanma koruması veya düşük bitlik ortam modu etkinleştirildiğinde, kadran güvenli olduğu için küçük yanma koruması resmini kullanabilir. Aksi takdirde, kadran uygunluğu belirlemekte zorlandığı için resim gösterilmez.
LARGE_IMAGE Büyük resim
 İçerik açıklaması
 Bu resmin, kadranı dolduracak kadar büyük olması gerekir. 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 toplamının belirli bir değere ulaşması gerekmez. Kadranların WEIGHTED_ELEMENTS öğesini yeniden renklendirmesine izin verildiğini unutmayın.

Aşağıdaki tabloda, herhangi bir komplikasyon yuvası için gönderilebilecek boş verilere ilişkin komplikasyon türleri açıklanmaktadır. Bu türlerde alan bulunmaz ve desteklenen türler listesine eklenmeleri gerekmez. Bu türler, kadranlarda aşağıdaki üç durum arasında ayrım yapılmasını 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.

Kaynaklar tarafından gönderilemez.

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

Kaynak tarafından gönderilemez.

TYPE_NO_DATA Kaynağı olan bir komplikasyon etkinleştirildiğinde sistem tarafından gönderilir. Bu, kaynaktan gerçek veriler alınmadan önce komplikasyonu temizlemek için yapılır.

Gönderecek gerçek verileri yoksa kaynaklar tarafından gönderilebilir.

Bazı cihazlarda kadranlar ve komplikasyonlar, Saat Kadranı Formatı'nı kullanmalıdır.

Mevcut kadranınızda Jetpack Kadran Kitaplığı veya Giyilebilir Cihaz Destek Kitaplığı kullanılıyorsa kullanıcılar, aşağıdaki cihazlarda kadran komplikasyonlarındaki tüm veri kaynaklarından gelen verileri görmeye devam eder:

  • Wear OS 4 veya önceki sürümlerin yüklü olduğu cihazlar.
  • Wear OS 5'e kablosuz olarak yükseltilen cihazlar.

Ayrıca, mevcut kadranınız Jetpack Kadran Kitaplığı veya Giyilebilir Cihaz Destek Kitaplığı'nı kullanıyorsa ve bu cihazlardan birine yüklüyse kadran güncelleme almaya devam edebilir.

Ancak Wear OS 5 ile kullanıma sunulan yeni saatlerde kadranların Saat Kadranı Formatı'nı kullanması gerekir. Bu nedenle, kadran biçimini kullanmaya geçmenizi öneririz.