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

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

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

بناء الجملة

<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 على عنصر Bounding Area واحد بالضبط.

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

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

  • ملاحظة: يتم عرض نص الرابط عندما تكون لغة JavaScript غير مفعّلة.
  • PartImage
  • PartText