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

description: يوضّح هذا المستند كيفية إضافة إضافات خلفية شاشة الساعة وإعدادها على Wear OS باستخدام "تنسيق خلفية شاشة الساعة"، مع توضيح أنواع الإضافات المتاحة وحقولها. keywords_public: Android,Wear OS,watch faces,complications,Watch Face Format,ComplicationData,data sources

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

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

يتيح لك العنصر Complication تحديد ما يصل إلى ثماني إضافات ضمن خلفية شاشة ساعة واحدة. يتيح لك العنصر أيضًا تحديد موضع ظهور كل إضافة على خلفية شاشة الساعة.

لمزيد من المعلومات، يمكنك الاطّلاع على نموذج WatchFaceFormat على GitHub.

الأنواع والحقول

يوضّح الجدول التالي أنواع وحقول العنصر ComplicationData. إذا طلبت خلفية شاشة حقلًا غير صالح لنوع عنصر واجهة مستخدم، سيتم عرض قيمة تلقائية للحقل. على سبيل المثال، إذا حاولت خلفية شاشة ساعة الوصول إلى حقل LONG_TEXT في نوع SHORT_TEXT، سيتم عرض القيمة التلقائية للحقل LONG_TEXT، وهي القيمة null. يُرجى العِلم بأنّه لا نضمن عرض الحقول الاختيارية.





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

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

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

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