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

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

تم طرح هذه الميزة في 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 أيضًا على العناصر الداخلية التالية: