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

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

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

يتيح لك عنصر 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، يجب تطوير خلفيات شاشة الساعة باستخدام تنسيق خلفية شاشة الساعة. لهذا السبب، ننصحك باستخدام تنسيق خلفية شاشة الساعة.