إضافة إضافات إلى خلفية شاشة الساعة

تعرض إضافة خلفية شاشة الساعة بيانات من مصدر بيانات. باستخدام تنسيق خلفية شاشة الساعة، يمكنك اختيار مصادر البيانات للحصول على البيانات الأساسية. يتيح ذلك لخلفيات شاشة الساعة عرض المعلومات خارج أوقات اليوم دون الحاجة إلى رمز للحصول على البيانات.

استخدام تنسيق خلفية شاشة الساعة

يتيح لك عنصر 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 Face أو مكتبة Wearable Support Library، سيستمر ظهور البيانات من جميع مصادر البيانات في الإضافات في خلفية شاشة الساعة على الأجهزة التالية:

  • الأجهزة التي تعمل بالإصدار 4 من نظام التشغيل Wear OS أو الإصدارات الأقدم
  • الأجهزة التي تتلقّى ترقية عبر شبكة غير سلكيّة إلى Wear OS 5

بالإضافة إلى ذلك، إذا كانت خلفية شاشة الساعة الحالية تستخدم مكتبة Jetpack Watch Face أو مكتبة Wearable Support Library وكانت مثبّتة على أحد هذه الأجهزة، يمكن أن تستمر خلفية شاشة الساعة في تلقّي التحديثات.

ومع ذلك، يجب أن تستخدم خلفيات شاشة الساعة تنسيق خلفية شاشة الساعة في الساعات الجديدة التي تم إطلاقها مع نظام التشغيل Wear OS 5. لهذا السبب، ننصحك باستخدام تنسيق خلفية شاشة الساعة.