Özellik, kadranda zamana ek olarak gösterilen herhangi bir özelliktir. Örneğin, pil göstergesi bir komplikasyondur. Complications API hem kadranlar hem de veri kaynağı uygulamaları için kullanılabilir.
Bu belgenin geri kalanında veri kaynakları, kadranlar ve komplikasyon türleri açıklanmıştır.
Özellik (komplikasyon) veri kaynağı
Saat kadranlarında özellikler için pil seviyesi, hava durumu veya adım sayısı gibi veriler sağlayan uygulamalara komplikasyon veri kaynakları adı verilir. Ham veri sağlayan bu veri kaynakları, verilerinin kadranlarda nasıl oluşturulduğunu kontrol etmekten sorumlu değildir. Saat yüzlerine veri sağlayan uygulamalara yazma hakkında bilgi edinmek için Özelliklere veri gösterme bölümüne göz atın.
Aşağıdaki şemada, Wear OS by Google'ın kaynaklardan saat yüzlerine veri akışını nasıl uyumlulaştırdığı gösterilmektedir.
![Özellikler veri akışı Özellikler veri akışı](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=5&hl=tr)
Kadranlardaki özellikler
Kadranlar, özellik veri kaynaklarından veri alır. Bu sayede, temel bilgileri almak için koda ihtiyaç duymadan özellikleri kullanabilirler. Kadranlar, verilerin işlenme şekli üzerinde kontrol sahibi olduğundan verileri tasarımlarıyla doğal bir şekilde entegre edebilir. Daha fazla bilgi için Komplikasyonlar hakkındaki tasarım kılavuzuna bakın.
Bir kadrana nasıl özellik ekleyeceğinizi öğrenmek için Saat yüzüne özellikler ekleme konusuna bakın.
Özellik (komplikasyon) türleri
Komplikasyon türleri, bir özellikte gösterilebilecek veya bir veri kaynağı tarafından sağlanabilecek veri türlerini tanımlar. Örneğin, veriler ağırlıklı olarak kısa bir dizeden oluşuyorsa SHORT_TEXT
türünü kullanın.
ComplicationData
nesnesi her zaman, zorunlu ve isteğe bağlı alanları tanımlayan tek bir özellik türüne sahiptir. Zorunlu alan, birincil veri parçasını temsil eder. Çoğu tür, adını zorunlu alandan alır.
Veri kaynakları, komplikasyon türlerini saat kadranlarından farklı şekilde kullanır:
- Veri kaynağı, sağlanacak komplikasyon verisi türlerini seçer. Buna, bu türlerden hangi isteğe bağlı alanların sağlanması ve kaç farklı türün desteklenebileceği de dahildir. Örneğin, adım sayısı kaynağı
RANGED_VALUE
veSHORT_TEXT
türlerini, sonraki toplantı kaynağı daSHORT_TEXT
veLONG_TEXT
türlerini destekleyebilir. - Kadranınızda kaç özellik içereceğinizi ve desteklenecek komplikasyon türlerini seçebilirsiniz. Örneğin, bir kadrandaki kadran özelliği
SHORT_TEXT
,ICON
veRANGED_VALUE
türlerini destekleyebilir. Kadrandaki gösterge yalnızcaRANGED_VALUE
türünü destekleyebilir.
Her bir türün desteklediği farklı özellik türleri ve alanları hakkında daha fazla bilgi edinmek için Komplikasyon türleri bölümünü inceleyin.