Kadrana özellik ekleme

Kadran komplikasyonu, bir veri kaynağından gelen verileri gösterir. Kadran biçimi'ni kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Bu sayede, kadranlarınızda günün saati dışındaki bilgileri, kod kullanmadan gösterebilirsiniz.

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österileceğ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. Bir kadran, komplikasyon türü için geçersiz bir alan isterse alan için varsayılan 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ı

 Yalnızca bir simge veya kısa başlık (her ikisi de sağlanmışsa) gösterilir.
MONOCHROMATIC_IMAGE Tek renkli resim
 Yanma koruması simgesi
İçerik açıklaması

 Metin gerekmediğinde kullanılır. Simgenin tek renkli olması beklenir ve kadran tarafından renklendirilebilir.
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 ComplicationDrawable sınıfı tarafından sağlanan ilerleme çubuğunu gizlemek için isRangedValueProgressHidden() yöntemini kullanabilirsiniz.
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
Yanma koruması 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 fotoğraf stili veya simge stili olmak üzere iki stilden birine sahiptir. 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ülemek 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, yanmaya karşı korumalı veya düşük bitlik ambiyans modu olan cihazlarda ambiyans modunda görüntülemek için uygun olmayan bir görüntüye neden olabilir. Bir kadranın ekrana uygunluğunu belirlemesi zor olduğundan, piksel yanma koruması veya düşük bitlik ambiyans etkinse kadran, ambiyans modunda resim göstermez.
WEIGHTED_ELEMENTS Öğe listesi
 Tek renkli resim
Yanma koruması 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ürlerin alanı yoktur ve desteklenen türlerin listesine dahil edilmeleri gerekmez. Bu türler, kadranlarda aşağıdaki üç durum arasında ayrım yapılmasını sağlar:

  • Kaynak seçilmedi
  • Kullanıcı, bir slot için "boş"u seçtiyse
  • 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 komplikasyon etkinleştirildiğinde ancak kullanıcı bir kaynak seçmemişse 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ı bir 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.

Kaynaklar 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ümleri çalıştıran 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 kol saatlerinde kadranlar Kadran Formatı'nı kullanmalıdır. Bu nedenle, kadran biçimini kullanmaya geçmenizi öneririz.