Özellikler hakkında

Komplikasyon, kadran üzerinde saate ek olarak gösterilen tüm özelliklerdir. Örneğin, pil göstergesi bir komplikasyondur. Complications API, hem saat yüzleri hem de veri kaynağı uygulamaları için kullanılır.

Bu belgenin geri kalanında veri kaynakları, saat yüzleri ve komplikasyon türleri açıklanmaktadır.

Komplikasyon veri kaynağı

Özellikler için kadranlara pil seviyesi, hava durumu veya adım sayısı gibi veriler sağlayan uygulamalara özellik veri kaynakları adı verilir. Bu veri kaynakları ham veri sağlar ve verilerinin saat yüzünde nasıl oluşturulacağını kontrol etmekten sorumlu değildir. Saat yüzlerine veri sağlayan uygulamalar yazma hakkında bilgi edinmek için Özelliklere veri gösterme başlıklı makaleyi inceleyin.

Aşağıdaki şemada, Wear OS by Google'ın kaynaklardan saat yüzlerine veri akışını nasıl yönettiği gösterilmektedir.

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

Saat yüzlerindeki özellikler

Saat yüzleri, komplikasyon veri kaynaklarından veri alır. Bu sayede, temel verileri almak için koda ihtiyaç duymadan komplikasyonlar içerebilir. Saat yüzleri, verilerin nasıl oluşturulacağı üzerinde kontrol sahibi olmaya devam eder. Bu sayede verileri tasarımlarıyla doğal bir şekilde entegre edebilirler. Daha fazla bilgi için Komplikasyonlar ile ilgili tasarım kılavuzuna bakın.

Kadranlara nasıl özellik ekleneceğini öğrenmek için Kadranlara özellik ekleme başlıklı makaleyi inceleyin.

Özellik türleri

Komplikasyon türleri, komplikasyonda 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ştuğunda SHORT_TEXT türünü kullanın. Bir ComplicationData nesnesi, her zaman gerekli ve isteğe bağlı alanları tanımlayan tek bir komplikasyon türüne sahiptir. Zorunlu bir alan, birincil veri parçasını temsil eder. Çoğu tür, adını zorunlu alandan alır.

Veri kaynakları, komplikasyon türlerini saat yüzlerinden farklı şekilde kullanır:

  • Bir veri kaynağı, hangi türlerin isteğe bağlı alanları da dahil olmak üzere hangi komplikasyon verisi türlerinin sağlanacağını ve kaç farklı türün desteklenebileceğini seçer. Örneğin, adım sayısı kaynağı RANGED_VALUE ve SHORT_TEXT türlerini, sonraki toplantı kaynağı ise SHORT_TEXT ve LONG_TEXT türlerini destekleyebilir.
  • Saat yüzünüze kaç komplikasyon ekleyeceğinizi ve hangi komplikasyon türlerini destekleyeceğinizi seçebilirsiniz. Örneğin, bir kadran komplikasyonu, kadran üzerinde SHORT_TEXT, SMALL_IMAGE ve RANGED_VALUE türlerini destekleyebilir. Saat kadranındaki bir gösterge yalnızca RANGED_VALUE türünü destekleyebilir.

Farklı komplikasyon türleri ve her tür tarafından desteklenen alanlar hakkında daha fazla bilgi edinmek için Komplikasyon türleri başlıklı makaleyi inceleyin.