المساحة الإضافية هي منطقة على خلفية شاشة الساعة يمكن للمستخدم إضافة إضافة إليها. تحتوي الخانات الإضافية على عناصر إضافة تحدد طريقة عرض الإضافات لمختلف أنواع الإضافات وفي أوضاع مختلفة لخلفية شاشة الساعة.
تم طرح هذا الإصدار في نظام التشغيل 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
أيضًا على العناصر الداخلية التالية:
أفلام مُقترَحة لك
- ملاحظة: يظهر نص الرابط عند إيقاف JavaScript
- partImage
- partVectorImage
- جزء النص