Özellik, saat yüzünde gösterilen zamana ek olarak gösterilen herhangi bir özelliktir. Örneğin, bir pil göstergesi bir komplikasyondur. Complications API hem kadran hem de veri kaynağı uygulamaları içindir.
Bu belgenin geri kalanında veri kaynakları, kadranlar ve komplikasyon türleri açıklanmaktadır.
Özellik (komplikasyon) veri kaynağı
Saat yüzleri özellikleri için pil seviyesi, hava durumu veya adım sayısı gibi verileri sağlayan uygulamalara komplikasyon veri kaynakları adı verilir. Bu veri kaynakları, ham veri sağlar ve verilerinin kadranda nasıl oluşturulduğunu kontrol etmekten sorumlu değildir. Saat yüzlerine veri sağlayan uygulamaları yazma hakkında bilgi edinmek için Özelliklere verileri gösterme bölümüne bakın.
Aşağıdaki şemada, Wear OS by Google'ın kaynaklardan kadranlara veri akışını nasıl uyumlulaştırdığı gösterilmektedir.
Kadranlardaki özellikler
Kadranlar, karmaşık veri kaynaklarından veri alır. Böylece, temel bilgileri almak için koda ihtiyaç duymadan özellik (özellikler) içerebilirler. Kadranlar verilerin oluşturulma şeklini kontrol edebildiği için verileri tasarımlarıyla doğal bir şekilde entegre edebilirler. Daha fazla bilgi için Özellikler ile ilgili tasarım kılavuzuna bakın.
Not: Wear OS'in kullanıma sunulacak sürümlerinde, kullanıcı verileri içeren özellikleri desteklemek için saat yüzlerinin Saat Kadranı Biçimini kullanması gerekecektir. Kadranınızı, Saat Yüzü Biçimini kullanacak şekilde güncellemeniz önerilir. Özelliklerde yapılan bu değişiklikler hakkında daha fazla bilgi edinin.
Kadrana özellik ekleme hakkında bilgi edinmek için Kadranlara özellikler ekleme konusuna bakın.
Özellik (komplikasyon) türleri
Komplikasyon türleri, bir özellikte ne tür verilerin gösterilebileceğini veya bir veri kaynağı tarafından sağlanabileceğini tanımlar. Örneğin, veriler ağırlıklı olarak kısa bir dizeden oluşuyorsa SHORT_TEXT
türünü kullanın. Bir
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 özellik verisi türlerini seçer. Bunlara, bu türlerin hangi isteğe bağlı alanlarının sunulacağı ve kaç farklı türün desteklenebileceği de dahildir. Örneğin, adım sayısı kaynağı
RANGED_VALUE
veSHORT_TEXT
türlerini, bir sonraki toplantı kaynağı daSHORT_TEXT
veLONG_TEXT
türlerini destekleyebilir. - Kadranınıza kaç özellik ekleyeceğinizi ve desteklenecek özellik türlerini seçebilirsiniz. Örneğin, bir saat yüzündeki çevirme özelliği
SHORT_TEXT
,ICON
veRANGED_VALUE
türlerini destekleyebilir. Saat yüzündeki bir gösterge yalnızcaRANGED_VALUE
türünü destekleyebilir.
Farklı özellik türleri ve her türün desteklediği alanlar hakkında daha fazla bilgi edinmek için Komplikasyon türleri bölümüne bakın.