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, verileri almak için koda gerek kalmadan saat yüzlerinizde günün saatinden daha fazla bilgi gösterilebilir.

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ı

 Bir veya her ikisi de sağlanmışsa yalnızca bir simge ya da kısa başlık gösterir.
MONOCHROMATIC_IMAGE Tek renkli görüntü
 Piksel 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
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 ComplicationDrawable sınıfı tarafından sağlanan ilerleme çubuğunu gizlemek için isRangedValueProgressHidden() 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 şeyler için tasarlanmıştır.
LONG_TEXT Uzun metin
 Uzun başlık
Tek renkli resim
Sabit 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, alanın doldurulması gerektiği ve fotoğrafın kırpılabileceği anlamına gelir. Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir. Görüntü değişkenliği, ambiyans modunda yanma koruması olan veya düşük bitli ambiyans modu olan cihazlarda görüntülenmeye uygun olmayan bir görüntüye neden olabilir. 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ü değişkenliği, ambiyans modunda yanma koruması olan veya düşük bitli ambiyans modu olan cihazlarda görüntülenmeye uygun olmayan bir görüntüye neden olabilir. Saat yüzünün, görüntüleme için uygunluğu belirlemesi zor olduğundan, ekran yanması 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 renkten 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ı için gönderilebilecek boş verilerle ilgili komplikasyon türleri açıklanmaktadır. Bu türlerin alanı yoktur ve desteklenen türler listesine eklenmeleri 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 kaynakta gönderilecek veri yoksa

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 ya da kadran kaynak seçmediğinde ve bu komplikasyon türünü varsayılan olarak belirlediğ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.