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.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir
- Wear OS'te kadran komplikasyonlarına veri gösterme
- Komplikasyon
- DefaultProviderPolicy