Kadran özelliği, bir veri kaynağından veri gösterir. Saat Kadranı Formatı'nı kullanarak temel verileri almak için veri kaynaklarını seçebilirsiniz. Bu sayede kadranlarınız, verileri almak için koda gerek kalmadan, günün ilerleyen saatlerinde bilgi gösterebilir.
Saat Kadranı Formatı'nı kullanma
Complication
öğesi, tek bir kadranda sekiz adede kadar özellik tanımlamanıza olanak sağlar. Bu öğe, her bir özelliğin kadranda
nerede görüneceğini de tanımlamanızı sağlar.
Daha fazla bilgi için GitHub'daki WatchFaceFormat örneğine göz atın.
Türler ve alanlar
Aşağıdaki tabloda ComplicationData
nesnesinin türleri ve alanları açıklanmaktadır. Kadran, bir özellik türü için geçersiz olan bir alan isterse bu alan için varsayılan bir değer döndürülür. Örneğin, bir kadran SHORT_TEXT
türünde bir LONG_TEXT
alanına erişmeye çalışırsa LONG_TEXT
alanı için varsayılan değer olan null döndürülür. İsteğe bağlı alanların gösterilmesinin garanti edilmediğini unutmayın.
Tür | Zorunlu alanlar | İsteğe bağlı alanlar | Notlar |
---|---|---|---|
SHORT_TEXT
|
Kısa metin |
Simge Yerleşik koruma simgesi Kısa başlık İçerik açıklaması |
İkisinden biri veya her ikisi de sağlanmışsa yalnızca bir simge veya kısa başlık gösterir. |
MONOCHROMATIC_IMAGE
|
Tek renkli resim |
Yerleşik koruma simgesi İçerik açıklaması |
Metin gerekli olmadığında kullanılır. Simgenin tek renkli olması beklenir ve kadranda tonlama yapılabilir. |
RANGED_VALUE
|
Değer Minimum değer Maksimum değer |
Tek renkli resim Yerleşik koruma simgesi Kısa metin Kısa başlık Renk rampası Dinamik değer İçerik açıklaması |
Kendi ilerleme çubuğunuzu çizmek istiyorsanız
ComplicationDrawable sınıfının sağladığı ilerleme çubuğunu gizlemek için
isRangedValueProgressHidden() yöntemini kullanabilirsiniz.
|
GOAL_PROGRESS
|
Değer Target value (Hedef değer) |
Tek renkli resim Yerleşik koruma simgesi Kısa metin Kısa başlık Renk rampası Dinamik değer İçerik açıklaması |
GOAL_PROGRESS, değerin sıfırdan başladığı ve Hedef değeri aşmasına izin verilen adım sayısı gibi şeyler için tasarlanmıştır. |
LONG_TEXT
|
Uzun metin |
Uzun başlık Tek renkli resim Yerleşik koruma simgesi Küçük resim İçerik açıklaması |
Sağlanmışsa uzun başlığı gösterir. |
SMALL_IMAGE
|
Küçük resim |
İçerik açıklaması |
Küçük bir resmin iki stilden biri vardır: fotoğraf stili veya simge stili. Fotoğraf stili, alanı doldurması beklenen ve kırpılabilir. Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir.
Görüntü değişkenliği, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmek için uygun olmayan bir görüntüye neden olabilir. Yanma koruması veya düşük bitli ambiyans modu etkinleştirildiğinde kadran, güvenli olduğu için yanma korumasını küçük resmi kullanabilir. Aksi takdirde, kadran uygunluğu belirlemek zor olduğundan resim gösterilmez.
|
LARGE_IMAGE
|
Büyük resim |
İçerik açıklaması |
Bu resmin, kadranı dolduracak kadar büyük olması beklenir.
Görüntü değişkenliği, yanma korumalı veya düşük bitli ambiyans modu olan cihazlarda ambiyans modunda görüntülenmek için uygun olmayan bir görüntüye neden olabilir. Kadranın görüntülemeye uygun olup olmadığını belirlemesi zor olduğundan, yanma koruması veya düşük bitli ortam etkin olduğunda kadran, ambiyans modunda resim göstermez.
|
WEIGHTED_ELEMENTS
|
Öğe listesi |
Tek renkli resim Yerleşik koruma simgesi Kısa metin Kısa başlık İçerik açıklaması |
Her öğe, bir renk ve ağırlıktan (sıfırdan büyük) oluşur. Oluşturulan öğenin boyutu, ağırlığıyla orantılı olmalıdır. Ağırlıkların belirli bir değerle toplanması gerekmez. Kadranların WEIGHTED_ELEMENTS öğesinin yeniden renklendirilmesine izin verildiğini unutmayın. |
Aşağıdaki tabloda, herhangi bir özellik alanı için gönderilebilecek boş verilere yönelik özellik türleri açıklanmaktadır. Bu türlerde alan bulunmaz ve desteklenen türler listesine eklenmeleri gerekmez. Bu türler, kadranların aşağıdaki üç durumda ayırt edilmesini sağlar:
- Kaynak seçilmedi
- Kullanıcı bir alan için "boş" seçeneğini belirledi
- Bir kaynakta gönderilecek veri yok
Kaynaklar güncelleme isteklerine yanıt olarak TYPE_EMPTY
gönderemez. Bunun yerine TYPE_NO_DATA
gönderin.
Özellik türü | Açıklama |
---|---|
TYPE_NOT_CONFIGURED
|
Bir özellik etkinleştiğinde ancak kullanıcı bir kaynak seçmediğinde ve varsayılan ayarlanmadığında sistem tarafından gönderilir.
Kaynak tarafından gönderilemez. |
TYPE_EMPTY
|
Bir özellik etkinleştirildiğinde ve kullanıcı bir kaynak yerine "boş" seçeneğini belirlediğinde veya kadran hiç kaynak seçmediğinde ve bu özellik türünü varsayılan olarak seçtiğinde sistem tarafından gönderilir.
Kaynak tarafından gönderilemez. |
TYPE_NO_DATA
|
Kaynaktan gerçek veriler alınmadan önce özelliği temizlemek için kaynağı olan bir özellik etkinleştirildiğinde sistem tarafından gönderilir.
Gönderilecek gerçek veri yoksa kaynaklar tarafından gönderilebilir. |
Bazı cihazlarda, kadranlar ve özelliklerde Saat Kadranı Formatı kullanılmalıdır.
Mevcut kadranınızda Jetpack Saat Kadranı kitaplığı veya Giyilebilir Cihaz Destek Kitaplığı kullanılıyorsa kullanıcılar aşağıdaki cihazlardaki kadran özelliklerindeki tüm veri kaynaklarından gelen verileri görmeye devam ederler:
- Wear OS 4 veya önceki sürümlerin yüklü olduğu cihazlar.
- OTA'dan Wear OS 5'e yükseltme yapılan cihazlar.
Ayrıca, mevcut kadranınız Jetpack Saat Kadranı kitaplığını veya Giyilebilir Cihaz Destek Kitaplığı'nı kullanıyorsa ve bu cihazlardan birine yüklenmişse kadran güncellemeleri almaya devam edebilir.
Ancak Wear OS 5 ile kullanıma sunulan yeni saatlerde kadranların Saat Kadranı Formatı'nı kullanması gerekir. Bu nedenle, Saat Kadranı Formatı'nı kullanmaya geçmenizi öneririz.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir
- Verileri Wear OS'te kadran komplikasyonlarına gösterme
- Komplikasyon
- DefaultProviderPolicy