Saat yüzü komplikasyonu, bir veri kaynağındaki verileri gösterir. Saat Kadranı Formatı'ı kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Bu sayede, saat yüzlerinizde günün saatinden daha fazla bilgi gösterilebilir ve verileri almak için kod gerekmez.
Saat Kadranı Formatı'nı kullanma
Complication öğesi, tek bir kadran içinde en fazla sekiz komplikasyon 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 Piksel yanma koruma simgesi Kısa başlık İçerik açıklaması |
Her ikisi de veya bunlardan biri sağlanırsa 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 kadran tarafından renklendirilebilir. |
RANGED_VALUE
|
Değer Minimum değer Maksimum değer |
Tek renkli resim Piksel 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
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 Piksel yanma koruması 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 Piksel yanma koruması 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, piksel yanma koruması olan veya düşük bitli Ambiyans Modu bulunan cihazlarda Ambiyans Modu'nda 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 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, piksel yanma koruması olan veya düşük bitli Ambiyans Modu bulunan cihazlarda Ambiyans Modu'nda görüntülenmeye uygun olmayan bir görüntüye neden olabilir. 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 Piksel yanma koruması 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 verilir. |
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 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
|
Kaynak içeren 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 verisi 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 Giyilebilir Destek Kitaplığı'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, Saat Kadranı Formatı'nı kullanmaya geçmenizi öneririz.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir.
- Wear OS'teki kadran özelliklerine veri gösterme
- Complication
- DefaultProviderPolicy