复杂功能

Complication 元素定义了特定 Complication 类型如何在表盘上显示。

对于每种类型的复杂功能，您可以在表达式中使用以下内容。这使您可以访问提供给复杂功能的数据

  • 所有类型以及EMPTY
    • COMPLICATION.TYPE
    • COMPLICATION.TAP_ACTION
  • LONG_TEXT:
    • COMPLICATION.MONOCHROMATIC_IMAGE
    • COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT
    • COMPLICATION.SMALL_IMAGE
    • COMPLICATION.SMALL_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元素可以包含任意数量的以下内部元素