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

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

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

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