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

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

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

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