Özellikler hakkında

Ö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ışı
Şekil 1. Özellik (komplikasyon) verilerinin akışı.

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 ve SHORT_TEXT türlerini, sonraki toplantı kaynağı da SHORT_TEXT ve LONG_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 ve RANGED_VALUE türlerini destekleyebilir. Kadrandaki gösterge yalnızca RANGED_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.