Kadrana özellik ekleme

Saat yüzü komplikasyonu, bir veri kaynağındaki verileri gösterir. Watch Face Format'ı kullanarak temel verileri alacağınız veri kaynaklarını seçebilirsiniz. Bu sayede, saat yüzlerinizde günün saatinden daha fazla bilgi gösterilebilir. Verileri almak için kod gerekmez.

Saat Kadranı Formatı'nı kullanma

Complication öğesi, tek bir kadran içinde en fazla sekiz özellik tanımlamanıza olanak tanır. Bu öğe, her komplikasyonun kadranın neresinde 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. Bir saat yüzü, komplikasyon türü için geçersiz olan bir alan isterse alan için varsayılan bir değer döndürülür. Örneğin, bir saat yüzü SHORT_TEXT türünde 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
Sabit görüntü koruma simgesi
Kısa başlık
İçerik açıklaması

 Her ikisi de veya yalnızca biri sağlanmışsa yalnızca bir simge ya da kısa başlık gösterilir.
MONOCHROMATIC_IMAGE Tek renkli resim
 Piksel yanma koruması simgesi
İçerik açıklaması

 Metin gerekmediğinde kullanılır. Simgenin tek renkli olması beklenir ve saat yüzü tarafından renklendirilebilir.
RANGED_VALUE Değer
Minimum değer
Maksimum değer
 Tek renkli resim
Sabit görüntü 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 isRangedValueProgressHidden() sınıfı tarafından sağlanan ilerleme çubuğunu gizlemek için ComplicationDrawable yöntemini kullanabilirsiniz.
GOAL_PROGRESS Değer
Hedef değeri
 Tek renkli resim
Sabit görüntü 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 öğeler için tasarlanmıştır.
LONG_TEXT Uzun metin
 Uzun başlık
Tek renkli resim
Ekranda kalıcı görüntü koruma simgesi
Küçük resim
İçerik açıklaması
 Sağlanırsa uzun başlığı gösterir.
SMALL_IMAGE Küçük resim
 İçerik açıklaması
 Küçük resimler iki stilden birine sahiptir: fotoğraf stili veya simge stili. Fotoğraf stili, fotoğrafın alanı doldurması ve kırpılabilmesi gerektiği anlamına gelir. Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir. Görüntüdeki değişkenlik, ambiyans modunda görüntülenmeye uygun olmayan bir resimle sonuçlanabilir. Bu durum, özellikle de ekran yanması koruması olan veya düşük bitli ambiyans modu kullanılan cihazlarda geçerlidir. Piksel yanması koruması veya düşük bitli ortam modu etkinleştirildiğinde, güvenli olduğu için saat yüzünde piksel yanması koruması için kullanılan küçük resim kullanılabilir. Aksi takdirde, uygunluğu belirlemek zor olduğundan saat yüzünde resim gösterilmez.
LARGE_IMAGE Büyük resim
 İçerik açıklaması
 Bu resmin, saat yüzünü dolduracak kadar büyük olması beklenir. Görüntüdeki değişkenlik, ambiyans modunda görüntülenmeye uygun olmayan bir resimle sonuçlanabilir. Bu durum, özellikle de ekran yanması koruması olan veya düşük bitli ambiyans modu kullanılan cihazlarda geçerlidir. Saat yüzünün, ekran için uygunluğu belirlemesi zor olduğundan, piksel yanma koruması veya düşük bitli ambiyans modu etkinse saat yüzü, ambiyans modunda görüntü göstermez.
WEIGHTED_ELEMENTS Öğe listesi
 Tek renkli resim
Sabit görüntü 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şturulduğunda öğenin boyutu, ağırlığıyla orantılı olmalıdır. Ağırlıkların belirli bir değere eşit olması gerekmez. Kadranların WEIGHTED_ELEMENTS öğelerini yeniden renklendirmesine izin verildiğini unutmayın.

Aşağıdaki tabloda, herhangi bir komplikasyon yuvasına gönderilebilecek boş veriler için komplikasyon türleri açıklanmaktadır. Bu türlerin alanı yoktur ve desteklenen türler listesine dahil edilmeleri gerekmez. Bu türler, saat yüzlerinin aşağıdaki üç durumu ayırt etmesini sağlar:

  • Kaynak seçilmedi
  • Kullanıcı bir yuva için "boş"u seçtiyse
  • Bir kaynağın gönderecek verisi 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çmediğinde ve varsayılan ayar belirlenmediğinde 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 kaynak seçmediğinde ve bu komplikasyon türünü varsayılan olarak seçtiğinde sistem tarafından gönderilir.

Kaynaklar tarafından gönderilemez.

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

Gönderilecek gerçek verileri olmayan kaynaklar tarafından gönderilebilir.

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

Mevcut kadranınız Jetpack Watch Face kitaplığını veya Wearable Support Library'yi kullanı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 OTA yükseltmesi alan cihazlar.

Ayrıca, mevcut kadranınız Jetpack Watch Face kitaplığını veya Giyilebilir Cihaz Destek Kitaplığı'nı kullanıyorsa ve bu cihazlardan birine yüklendiyse kadran güncellemeler almaya devam edebilir.

Ancak Wear OS 5 ile kullanıma sunulan yeni kol saatlerinde kadranların Saat Kadranı Formatı'nı kullanması zorunludur. Bu nedenle, Watch Face Format'ı kullanmaya geçmenizi öneririz.