Kadrana özellik ekleme

Saat yüzü özelliği, bir veri kaynağından gelen verileri gösterir. Saat Kadranı Formatı'nı kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Böylece kadranlarınız, verileri almak için koda ihtiyaç duymadan bilgileri günün saatinden sonra gösterebilir.

Saat Kadranı Biçimini kullanın

Complication öğesi, tek bir kadranda sekiz adede kadar özellik tanımlamanızı sağlar. Öğe, her bir özelliğin saat yüzünde nerede görüneceğini tanımlayabilmenizi de sağlar.

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, bir özellik 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 kadran, SHORT_TEXT türündeki bir LONG_TEXT alanına erişmeye çalışırsa LONG_TEXT alanı için varsayılan değer olan null döndürülür. İsteğe bağlı alanların gösterilmesinin garanti edilmediğini unutmayın.





Tür Zorunlu alanlar İsteğe bağlı alanlar Notlar
SHORT_TEXT Kısa metin Simge
Yerleşik koruma simgesi
Short title
Content description

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

Metin gerekli olmadığında kullanılır. Simgenin tek renkli olması beklenir ve saat yüzüne göre renklendirilmiş olabilir.
RANGED_VALUE Değer
Min değer
Maks. değer
Tek renkli resim
Yerleşik 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ğer
Tek renkli resim
Yerleşik 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 işlevler 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ı
Sağlanmışsa uzun başlığı gösterir.
SMALL_IMAGE Küçük resim
İçerik açıklaması
Küçük resimlerin iki stili vardır: fotoğraf stili veya simge stili. Fotoğraf stili, alanı doldurmasının beklendiği ve kırpılabileceği anlamına gelir. Simge stili, kırpılamayacağı ve dolgulu olabileceği anlamına gelir. Görüntü değişkenliği, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmeye uygun olmayan görüntülere neden olabilir. Yanma koruması veya düşük bit ambiyans modu etkinleştirildiğinde kadranda güvenli olduğu için yanma koruması küçük görüntü kullanılabilir. Aksi takdirde, kadranın uygunluğu belirlemesi zor olduğundan 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, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmeye uygun olmayan görüntülere neden olabilir. Bir kadranın ekrana uygun olup olmadığını belirlemesi zor olduğundan, yanma koruması veya düşük bitli ortam etkinleştirilirse kadranda ambiyans modunda görüntü gösterilmez.
WEIGHTED_ELEMENTS Öğe listesi
Tek renkli resim
Yerleşik koruma simgesi
Short text
Short title
Content description
Her öğe, bir renk ve ağırlıktan (sıfırdan büyük) oluşur. Öğenin oluşturulurken boyutu, ağırlığıyla orantılı olmalıdır. Ağırlıkların belirli bir değerin toplanması için kullanılması gerekmez. Saat yüzlerinin WEIGHTED_ELEMENTS renginin yeniden renklenmesine izin verildiğini unutmayın.

Aşağıdaki tabloda, herhangi bir komplikasyon alanı için gönderilebilecek boş verilere yönelik özellik türleri açıklanmaktadır. Bu türlerin alanı yoktur ve desteklenen türler listesine dahil edilmeleri gerekmez. Bu türler, kadranların aşağıdaki üç durum arasında ayrım yapması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önder.

Özellik (komplikasyon) türü Açıklama
TYPE_NOT_CONFIGURED Bir özellik etkinleştirildiğ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 özellik etkinleştirildiğinde ve kullanıcı kaynak yerine "boş"u seçtiğinde veya kadranı kaynak seçmediğinde ve varsayılan olarak bu özellik türünü seçtiğinde sistem tarafından gönderilir.

Kaynaklar tarafından gönderilemez.

TYPE_NO_DATA Kaynağı olan bir özellik, kaynaktan gerçek veriler alınmadan önce özelliği temizlemek için sistem tarafından gönderilir.

Gönderilecek gerçek veri yoksa kaynaklar tarafından gönderilebilir.

Çoğu veri kaynağı için Saat Kadranı Biçimi gerekir

Wear OS'in kullanıma sunulacak sürümlerindeki kadran özelliklerinin görünümünü korumak için Saat Kadranı Formatı'nı kullanmanız gerekir. Kadranınız bunun yerine Jetpack Saat Yüzü kitaplığını veya Giyilebilir Destek Kitaplığı'nı kullanıyorsa Wear OS'in yeni sürümleri, kadran özelliklerinde çoğu veri kaynağından veri göstermez.

Saat Kadranı Biçimini kullanmayan saat yüzlerindeki özelliklerin görünümünü tam olarak korumak için kadranlar özellik alanlarında aşağıdaki veri kaynaklarından birini kullanmalıdır:

Cihaz üreticisine bağlı olarak, Saat Kadranı Biçiminin kullanılmadığı kadranlarda birkaç ek komplikasyon kaynağı gösterilebilir.