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