تعرِض الإضافات في خلفية شاشة الساعة بيانات من مصدر بيانات. باستخدام تنسيق خلفية شاشة الساعة، يمكنك اختيار مصادر البيانات للحصول على البيانات الأساسية. يتيح لك ذلك عرض معلومات أخرى غير الوقت على خلفيات شاشة الساعة بدون الحاجة إلى رمز للحصول على البيانات.
استخدام تنسيق خلفية شاشة الساعة
يتيح لك العنصر Complication
تحديد ما يصل إلى ثماني إضافات ضمن
خلفية شاشة ساعة واحدة. يتيح لك العنصر أيضًا تحديد مكان ظهور كل ميزة إضافية
على خلفية شاشة الساعة.
لمزيد من المعلومات، يمكنك الاطّلاع على نموذج WatchFaceFormat على GitHub.
الأنواع والحقول
يوضّح الجدول التالي أنواع عنصر
ComplicationData
وحقوله. إذا طلبت خلفية شاشة الساعة حقلاً غير صالح
بالنسبة إلى نوع إضافة، يتم إرجاع قيمة افتراضية للحقل. على سبيل المثال،
إذا حاولت خلفية شاشة الساعة الوصول إلى حقل LONG_TEXT
من النوع SHORT_TEXT
، يتم عرض
القيمة التلقائية للحقل LONG_TEXT
، وهي "فارغة". يُرجى العِلم بأنّه لا يمكن ضمان عرض الحقول الاختيارية.
النوع | حقول مطلوبة | حقول اختيارية | ملاحظات |
---|---|---|---|
SHORT_TEXT
|
نص قصير |
رمز رمز الحماية من تلف المحتوى عنوان قصير وصف المحتوى |
تعرض رمزًا واحدًا أو عنوانًا قصيرًا فقط في حال تم تقديمهما معًا. |
MONOCHROMATIC_IMAGE
|
صورة أحادية اللون |
رمز الحماية من الاحتراق وصف المحتوى |
تُستخدَم عندما لا يكون النص مطلوبًا. يجب أن يكون الرمز بلون واحد. وقد تكون ملوَّنة بخلفية شاشة الساعة. |
RANGED_VALUE
|
القيمة الحد الأدنى للقيمة الحدّ الأقصى للقيمة |
صورة أحادية اللون رمز الحماية من الاحتراق نص قصير عنوان قصير تدرج الألوان قيمة ديناميكية وصف المحتوى |
إذا كنت تريد رسم شريط التقدّم الخاص بك، يمكنك استخدام الأسلوب
isRangedValueProgressHidden() لإخفاء شريط التقدّم
المقدَّم من فئة
ComplicationDrawable .
|
GOAL_PROGRESS
|
القيمة القيمة المستهدَفة |
صورة أحادية اللون صورة رمزية للحماية من التأثير الدائم نص قصير عنوان قصير تدرج لوني قيمة ديناميكية وصف المحتوى |
الهدف GOAL_PROGRESS هو تنفيذ إجراءات مثل عدد الخطوات عند بدء القيمة عند صفر، ويُسمح له بتجاوز القيمة المستهدفة. |
LONG_TEXT
|
نص طويل |
عنوان طويل صورة أحادية اللون رمز الحماية من الاحتراق صورة صغيرة وصف المحتوى |
تعرِض هذه السمة العنوان الطويل في حال توفيره. |
SMALL_IMAGE
|
صورة صغيرة |
وصف المحتوى |
تتضمّن الصورة الصغيرة أحد النمطَين التاليَين: نمط الصورة أو نمط الرمز
. نمط الصورة يعني أنه من المتوقع أن يملأ المساحة ويمكن أن
التي تم اقتصاصها. نمط الرمز يعني أنه لا يمكن اقتصاصه ويمكن تبطينه.
يمكن أن يؤدي التباين في الصورة إلى ظهور صورة غير مناسبة للعرض
في وضع الاستراحة على الأجهزة التي تتضمّن ميزة حماية الشاشة من العرض المتكرّر أو التي تتضمّن وضع استراحة بدرجة دقة منخفضة
. عند تفعيل ميزة "الحماية من العرض الدائم للصورة" أو "وضع الإضاءة المنخفضة"،
قد تستخدم خلفية شاشة الساعة الصورة الصغيرة لميزة "الحماية من العرض الدائم للصورة"
لأنّها آمنة. وبخلاف ذلك، حيث إنه من الصعب على الساعة
لتحديد مدى الملاءمة، فلن يتم عرض الصورة.
|
LARGE_IMAGE
|
صورة كبيرة |
وصف المحتوى |
من المفترض أن تكون هذه الصورة كبيرة بما يكفي لملء خلفية شاشة الساعة.
يمكن أن يؤدي التباين في الصورة إلى ظهور صورة غير مناسبة للعرض
في وضع الاستراحة على الأجهزة التي تتضمّن ميزة حماية الشاشة من العرض المتكرّر أو التي تتضمّن وضع استراحة بدرجة دقة منخفضة
. بما أنّه من الصعب على خلفية شاشة الساعة تحديد
مدى ملاءمتها للعرض،
لا تعرض خلفية شاشة الساعة صورة
في وضع الإضاءة السينمائية إذا كان وضع الحماية من تلف الشاشة أو وضع الإضاءة السينمائية بدرجة بت منخفضة مفعَّلاَن.
|
WEIGHTED_ELEMENTS
|
قائمة العناصر |
صورة أحادية اللون رمز الحماية من الاحتراق نص قصير عنوان قصير وصف المحتوى |
يتكون كل عنصر من لون ووزن (أكبر من صفر). تشير رسالة الأشكال البيانية يجب أن يكون حجم العنصر عند عرضه متناسبًا مع وزنه. لا يُشترط جمع قيم الترجيح لحساب أي قيمة معيّنة. يُرجى العِلم أنّه يُسمح لخلفيات شاشة الساعة بإعادة تلوين WEIGHTED_ELEMENTS. |
يوضّح الجدول التالي أنواع التطبيقات المصغّرة للبيانات الفارغة التي يمكن إرسالها إلى أي خانة تطبيق مصغّر. لا تحتوي هذه الأنواع على أي حقول وليس من الضروري إدراجها في قائمة بالأنواع المتوافقة. تفعِّل هذه الأنواع الساعة يجب التمييز بين الحالات الثلاث التالية:
- لم يتم اختيار أي مصدر.
- اختار المستخدم "فارغة" للحصول على خانة
- لا يتضمّن أحد المصادر أي بيانات لإرسالها
لا يمكن للمصادر إرسال "TYPE_EMPTY
" ردًا على
طلبات التحديث. إرسال TYPE_NO_DATA
بدلاً من ذلك.
نوع الإضافة | الوصف |
---|---|
TYPE_NOT_CONFIGURED
|
يرسله النظام عند تفعيل إضافة مع أنّ المستخدم لديه
لم يتم تحديد مصدر ولم يتم تعيين أي إعداد افتراضي.
لا يمكن إرسالها من خلال المصادر. |
TYPE_EMPTY
|
يتم إرسالها من النظام عند تفعيل إضافة واختيار المستخدم
"فارغ" بدلاً من مصدر، أو عندما لا تختَر خلفية شاشة الساعة
أي مصدر وتختار نوع الإضافة هذا كخيار تلقائي.
لا يمكن إرسالها من خلال المصادر. |
TYPE_NO_DATA
|
يرسله النظام عند إضافة إضافة تحتوي على مصدر.
يتم تنشيطها لإزالة الإضافة قبل استلام البيانات الفعلية
من المصدر.
يمكن أن ترسلها المصادر إذا لم تكن لديها بيانات فعلية لإرسالها. |
على بعض الأجهزة، يجب أن تستخدم خلفيات شاشة الساعة والإضافات تنسيق خلفية شاشة الساعة.
إذا كانت خلفية شاشة الساعة الحالية تستخدم مكتبة خلفيات Jetpack Watch Watch أو مكتبة الدعم القابلة للارتداء: يواصل المستخدمون الاطّلاع على البيانات من جميع مصادر البيانات. في إضافات خلفية شاشة الساعة على الأجهزة التالية:
- الأجهزة التي تعمل بالإصدار 4 من نظام التشغيل Wear OS أو الإصدارات الأقدم
- الأجهزة التي تتلقّى ترقية عبر شبكة غير سلكيّة إلى Wear OS 5
بالإضافة إلى ذلك، إذا كانت خلفية شاشة الساعة الحالية تستخدم مكتبة Jetpack Watch Face أو مكتبة Wearable Support Library وكانت مثبّتة على أحد هذه الأجهزة، يمكن أن تستمر خلفية شاشة الساعة في تلقّي التحديثات.
ومع ذلك، في الساعات الجديدة التي تم إطلاقها التي تعمل بنظام التشغيل Wear OS 5، يجب أن تستخدم خلفيات شاشة الساعة تنسيق خلفية شاشة الساعة: ولهذا السبب، نقترح أن تنتقل إلى استخدام تنسيق خلفية شاشة الساعة.
أفلام مُقترَحة لك
- ملاحظة: يتم عرض نص الرابط عندما تكون لغة JavaScript غير مفعّلة.
- عرض البيانات حول إضافات خلفيات شاشة الساعة على Wear OS
- الإضافة
- DefaultProviderPolicy