Özellikler hakkında

Ö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.

Özellikler veri akışı
Şekil 1. Komplikasyon verilerinin akışı.

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