Kadrana özellik ekleme

Kadran özelliği, bir veri kaynağından veri gösterir. Kadran biçimi'ni kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Bu, kadranlarınızın günün saatinden sonra başka bilgiler göstermesine olanak tanır hem de koda ihtiyaç duymazsınız.

Saat Kadranı Formatı'nı kullanma

Complication öğesi, aynı öğede sekiz adede kadar özellik tanımlamanıza olanak sağlar. tek bir kadran. Öğ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. 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ı .	Aşağıdaki durumlardan biri geçerliyse yalnızca bir simge veya kısa başlık gösterir: her ikisi de sağlanır.
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ğer'in başladığı adım sayısı gibi öğelere yöneliktir. ve Hedef değeri aşmasına izin verilir.
LONG_TEXT	Uzun metin	Uzun başlık Tek renkli resim Yanma koruması simgesi Küçük resim İçerik açıklaması	Sağlandıysa 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 anlamına gelir. 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ı beklenir. 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. Kadranı belirlemek zor olduğundan görüntülü reklamcılığa uygunluk, kadranda resim gösterilmiyor yanma koruması veya düşük bitli ortam etkinleştirilirse ambiyans modunda çalışır.
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 boş verilere ilişkin özellik türleri tüm komplikasyon alanları için gönderilebilir. Bu türlerde alan yok ve aynı zamanda desteklenen türlerin listesidir. Bu türler, kol saatinin farklı yüzleri bir arada kullanın:

• Kaynak seçilmedi
• Kullanıcı "boş" seçeneğini belirledi bir zaman aralığı için
• 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ı değiştiğinde sistem tarafından gönderilir kaynak seçilmedi ve varsayılan ayarlanmadı. Kaynaklar tarafından gönderilemez.
TYPE_EMPTY	Bir özellik etkinleştiğinde ve kullanıcı olduğunda sistem tarafından gönderilir "Boş"u seçer veya kadran kaynak seçmez ve bu özellik türü varsayılan olarak belirlenir. Kaynak tarafından gönderilemez.
TYPE_NO_DATA	Kaynağı olan bir özellik olduğunda sistem tarafından gönderilir gerçek veriler alınmadan önce karmaşıklığı gidermek için etkinleştirilir kaynaktan çıkarır. Gönderecek gerçek verileri yoksa kaynaklar tarafından gönderilebilir.

Bazı cihazlarda, kadranlar ve özelliklerde Saat Kadranı Formatı kullanılmalı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 Watch Kadranı kitaplığını kullanıyorsa veya Giyilebilir Cihaz Destek Kitaplığı'ndan bu cihazlardan birine kadran, güncellemeleri 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.