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