خانة إدخال المحتوى

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

تم طرح هذا الإصدار في نظام التشغيل Wear OS 4.

بناء الجملة

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

السمات

يتضمّن ComplicationSlot السمات التالية:

السمات المطلوبة

السمات التالية مطلوبة:

x وy وwidth وheight
مجموعة من الأعداد الصحيحة التي تحدّد حجم العنصر وموضعه.
slotId
معرّف رقمي فريد للخانة
supportedTypes
قائمة بأنواع الإضافات المتوافقة التي يمكنها تعبئة الخانة والقيم المسموح بإدراجها هي SHORT_TEXT وLONG_TEXT وMONOCHROMATIC_IMAGE وSMALL_IMAGE وPHOTO_IMAGE وRANGED_VALUE وEMPTY. ويمكن توفير عدة أنواع من الإضافات من خلال فصلها بمسافة (على سبيل المثال، SHORT_TEXT RANGED_VALUE).

السمات الاختيارية

السمات التالية اختيارية:

pivotX، pivotY
نقطة محورية ثنائية الأبعاد يتم تدوير العنصر بشأنها. كلتا القيمتين عبارة عن أرقام عائمة يتم قياسها لتلائم النطاق $ [0, 1] $.
angle
عدد الدرجات، التي يجب تدويرها في اتجاه عقارب الساعة، حول نقطته المحورية
alpha
حدِّد مستوى الشفافية الذي يجب أن يتضمّنه هذا العنصر. تشير قيمة 0 إلى أن العنصر يجب أن يكون شفافًا تمامًا. تشير قيمة 255 إلى أن العنصر يجب أن يكون معتمًا تمامًا.
scaleX
عامل القياس الأفقي المطلوب تطبيقه على هذا العنصر
scaleY
عامل التحجيم العمودي المطلوب تطبيقه على هذا العنصر
tintColor
طبِّق فلتر درجة اللون على العنصر. عليك تحديد اللون باستخدام إما تنسيق ARGB (#ff000000 = أسود غامق) أو تنسيق RGB (#000000 = أسود).
displayName
معرّف مورد يتوافق مع الاسم المترجَم لخانة الإضافة، والذي يتم عرضه في أداة تعديل خلفية شاشة الساعة
isCustomizable
تحدِّد ما إذا كان يمكن للمستخدم تغيير موفّر الخدمة لهذه الخانة في أداة تعديل خلفية شاشة الساعة. وتكون القيمة التلقائية هي TRUE.

العناصر الداخلية

يجب أن يحتوي العنصر ComplicationSlot على عنصر منطقة حدود واحد فقط.

يجب أن يحتوي عنصر ComplicationSlot على عنصر إضافة على الأقل لكل "نوع إضافة" متوافق. يمكن أن يحتوي عنصر ComplicationSlot اختياريًا على المزيد من عناصر الإضافة لإتاحة تغيير المظهر مع عناصر خيار المنتج.

يمكن أن يحتوي العنصر ComplicationSlot أيضًا على العناصر الداخلية التالية: