إضافة

يحدد عنصر الإضافة كيفية عرض "نوع إضافة" معيّن على خلفية شاشة الساعة.

بالنسبة إلى كل نوع من الإضافة، يمكنك استخدام ما يلي في التعبيرات. يتيح لك هذا الإجراء الوصول إلى البيانات المقدَّمة للإضافة:

  • كل الأنواع وEMPTY:
    • [COMPLICATION.TYPE]
    • [COMPLICATION.TAP_ACTION]
  • LONG_TEXT:
    • [COMPLICATION.MONOCHROMATIC_IMAGE]
    • [COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]
  • MONOCHROMATIC_IMAGE:
    • [COMPLICATION.MONOCHROMATIC_IMAGE]
    • [COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
  • PHOTO_IMAGE:
    • [COMPLICATION.PHOTO_IMAGE]
  • RANGED_VALUE:
    • [COMPLICATION.MONOCHROMATIC_IMAGE]
    • [COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]
    • [COMPLICATION.RANGED_VALUE_MIN]
    • [COMPLICATION.RANGED_VALUE_MAX]
    • [COMPLICATION.RANGED_VALUE_VALUE]
    • [COMPLICATION.RANGED_VALUE_COLORS] - (قائمة بألوان سداسية عشرية مفصولة بمسافات، على سبيل المثال #FF0000 #00FF00)
    • [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] - (قيمة منطقية تحدد ما إذا كان سيتم إدخال الألوان)
  • SHORT_TEXT:
    • [COMPLICATION.MONOCHROMATIC_IMAGE]
    • [COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]
  • SMALL_IMAGE:
    • [COMPLICATION.SMALL_IMAGE]
    • [COMPLICATION.SMALL_IMAGE_AMBIENT]
    • [COMPLICATION.IMAGE_STYLE] - (تتوافق مع القيم الترتيبية SmallImageType)
  • GOAL_PROGRESS:
    • [COMPLICATION.GOAL_PROGRESS_VALUE]
    • [COMPLICATION.GOAL_PROGRESS_TARGET_VALUE]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]
    • [COMPLICATION.GOAL_PROGRESS_COLORS] - (قائمة بألوان سداسية عشرية مفصولة بمسافات، على سبيل المثال #FF0000 #00FF00)
    • [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] - (قيمة منطقية تحدد ما إذا كان سيتم إدخال الألوان)
  • WEIGHTED_ELEMENTS:
    • [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] - (قائمة بألوان سداسية عشرية مفصولة بمسافات، على سبيل المثال #FF0000 #00FF00)
    • [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] - (قائمة بأوزان العناصر مفصولة بمسافات)
    • [COMPLICATION.WEIGHTED_ELEMENTS_BACKGROUND_COLOR]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]

للحصول على شرح كامل، يمكنك الاطّلاع على المثال.

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

بناء الجملة

<Complication type="string">
      <!-- Only the most common inner element is shown here. -->
      <Group>
      </Group>
</Complication>

مثال

يوضّح المثال التالي إضافة تحتوي على مكوّنات الصورة والعنوان والنص:

<Complication type="SHORT_TEXT">
    <PartImage x="35" y="16" width="22" height="22" pivotX="0.5" pivotY="0.5"
               name="SomeIcon" alpha="255">
        <Image resource="[COMPLICATION.MONOCHROMATIC_IMAGE]"/>
    </PartImage>
    <PartText x="18" y="39" width="56" height="22" pivotX="0.5" pivotY="0.5"
              name="SomeText" alpha="255">
        <Text align="CENTER" ellipsis="TRUE">
            <Font family="SYNC_TO_DEVICE" size="20" weight="NORMAL"
                  slant="NORMAL" color="#ffffffff">
                <Template>
                    %s
                    <Parameter expression="[COMPLICATION.TEXT]"/>
                </Template>
            </Font>
        </Text>
    </PartText>
    <PartText x="19" y="62" width="54" height="14" pivotX="0.5" pivotY="0.5"
              name="SomeTitle" alpha="255">
        <Text align="CENTER" ellipsis="TRUE">
            <Font family="SYNC_TO_DEVICE" size="12" weight="NORMAL"
                  slant="NORMAL" color="#ffadadad">
                <Template>
                    %s
                    <Parameter expression="[COMPLICATION.TITLE]"/>
                </Template>
            </Font>
        </Text>
    </PartText>
</Complication>

السمات

يجب أن يحتوي العنصر ComplicationSlot على السمة type. ويتم عرض العنصر إذا اختار المستخدم نوع إضافة مطابق. القيم المسموح بها هي SHORT_TEXT وLONG_TEXT وMONOCHROMATIC_IMAGE وSMALL_IMAGE وPHOTO_IMAGE وRANGED_VALUE وEMPTY.

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

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