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

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

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

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

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

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

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