Kadrana özellik ekleme

Kadran özelliği, bir veri kaynağından veri gösterir. Her bir Saat Kadranı Formatı'nı seçerseniz temel alınan verileri görmek için veri kaynaklarını seçebilirsiniz. dışı verilerdir. Bu, kadranlarınızın günün saatinden sonra başka bilgiler göstermesine olanak tanır hem de koda ihtiyaç duymazsınız.

Saat Kadranı Formatı'nı kullanma

Complication öğesi, içinde sekiz adede kadar özellik tanımlamanıza olanak sağlar. tek bir kadran. Bu öğe, kadranın neresinden olduğunu da tanımlamanıza olanak tanır. her komplikasyon görünür.

Daha fazla bilgi için şuradaki WatchFaceFormat örneğini inceleyin: GitHub.

Türler ve alanlar

Aşağıdaki tabloda ComplicationData nesnesini tanımlayın. Bir kadran geçersiz bir alan isterse bir özellik türü için, 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. Not isteğe bağlı alanlar gösterileceği garanti edilmez.





Tür Zorunlu alanlar İsteğe bağlı alanlar Notlar
SHORT_TEXT Kısa metin Simge
Yanma koruması simgesi
Kısa başlık
İçerik açıklaması

. 		Aşağıdaki durumlardan biri geçerliyse yalnızca bir simge veya kısa başlık gösterir: her ikisi de sağlanır.
MONOCHROMATIC_IMAGE Tek renkli resim
 Yanma koruması 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
Yanma koruması simgesi
Kısa metin
Kısa başlık
Renk düzeyi
Dinamik değer
İçerik açıklaması

. 		Kendi ilerleme çubuğunuzu çizmek isterseniz İlerleme çubuğunu gizlemek için isRangedValueProgressHidden() yöntemi sağlayan ComplicationDrawable sınıfı.
GOAL_PROGRESS Değer
Hedef değer
 Tek renkli resim
Yanma koruması simgesi
Kısa metin
Kısa başlık
Renk düzeyi
Dinamik değer
İçerik açıklaması

. 		GOAL_PROGRESS, Değer'in başladığı adım sayısı gibi öğelere yöneliktir. ve Hedef değeri aşmasına izin verilir.
LONG_TEXT Uzun metin
 Uzun başlık
Tek renkli resim
Yanma koruması 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 stilinden biri vardır: fotoğraf stili veya simge stil. Fotoğraf stili, alanı doldurması beklendiği anlamına gelir ve kırpıldı. Simge stili, kırpılamayacağı ve doldurulabileceği anlamına gelir. Resim değişkenliği, resmin gösterilmeye uygun olmamasına neden olabilir yanma korumalı veya düşük bit özellikli cihazlarda ambiyans modunda ambiyans modu. Yanma koruması veya düşük bitli ambiyans modu etkinken etkinleştirildiğinde, kadranda yanma koruması küçük resmi kullanılabilir. çünkü güvenli olduğu için. Aksi takdirde, kol saati uygun olup olmadığını belirlemek için bir resim görürseniz resim gösterilmez.
LARGE_IMAGE Büyük resim
 İçerik açıklaması
 Bu resmin, kadranı dolduracak kadar büyük olması beklenir. Resim değişkenliği, resmin gösterilmeye uygun olmamasına neden olabilir yanma korumalı veya düşük bit özellikli cihazlarda ambiyans modunda ambiyans modu. Kadranı belirlemek zor olduğundan görüntülü reklamcılığa uygunluk, kadranda resim gösterilmiyor yanma koruması veya düşük bitli ortam etkinleştirilirse ambiyans modunda çalışır.
WEIGHTED_ELEMENTS Öğe listesi
 Tek renkli resim
Yanma koruması 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. İlgili içeriği oluşturmak için kullanılan 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 boş verilere ilişkin özellik türleri tüm komplikasyon alanları için gönderilebilir. Bu türlerde alan yok ve aynı zamanda desteklenen türlerin listesi. Bu türler, kol saatinin farklı yüzleri bir arada kullanın:

  • Kaynak seçilmedi
  • Kullanıcı "boş" seçeneğini belirledi bir zaman aralığı için
  • Bir kaynakta gönderilecek veri yok

Kaynaklar şuna yanıt olarak TYPE_EMPTY gönderemez: güncelleme istekleri. Bunun yerine TYPE_NO_DATA gönderin.

Özellik türü Açıklama
TYPE_NOT_CONFIGURED Bir özellik etkinleştiğinde ancak kullanıcı değiştiğinde sistem tarafından gönderilir kaynak seçilmedi ve varsayılan ayarlanmadı.

Kaynak tarafından gönderilemez.

TYPE_EMPTY Bir özellik etkinleştiğinde ve kullanıcı olduğunda sistem tarafından gönderilir "Boş"u seçer veya kadran kaynak seçmez ve bu özellik türü varsayılan olarak belirlenir.

Kaynak tarafından gönderilemez.

TYPE_NO_DATA Kaynağı olan bir özellik olduğunda sistem tarafından gönderilir gerçek veriler alınmadan önce karmaşıklığı gidermek için etkinleştirilir kaynaktan çıkarır.

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 Watch Face kitaplığı veya Giyilebilir Cihaz Destek Kitaplığı ile kullanıcılar tüm veri kaynaklarından gelen verileri görmeye devam eder aşağıdaki cihazlarda kadran komplikasyonlarında:

  • Wear OS 4 veya önceki sürümlerin yüklü olduğu cihazlar.
  • OTA'dan Wear OS 5'e yükseltilen cihazlar.

Ayrıca, mevcut kadranınız Jetpack Watch Kadranı kitaplığını kullanıyorsa veya Giyilebilir Cihaz Destek Kitaplığı'ndan bu cihazlardan birine kadran, güncellemeleri almaya devam edebilir.

Ancak Wear OS 5 ile kullanıma sunulan yeni saatlerde kadranlarda şunlar kullanılmalıdır: Saat Kadranı Formatı. Bu nedenle, şuna taşımanızı öneriyoruz: Saat Kadranı Formatı.

ziyaret edin.