Complicação

Um elemento de complemento define como um tipo específico é exibido no mostrador do relógio.

Para cada tipo de complemento, você pode usar o seguinte em expressões para acessar os dados fornecidos a ela:

  • LONG_TEXT:
    • COMPLICATION.MONOCHROMATIC_IMAGE
    • COMPLICATION.SMALL_IMAGE
    • 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: uma lista de cores hexadecimais separada por espaços, por exemplo, #FF0000 #00FF00.
    • COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE: um booleano que especifica se as cores serão interpoladas
  • 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: corresponde aos valores ordinais de SmallImageType.
  • GOAL_PROGRESS:
    • COMPLICATION.GOAL_PROGRESS_VALUE
    • COMPLICATION.GOAL_PROGRESS_TARGET_VALUE
    • COMPLICATION.TEXT
    • COMPLICATION.TITLE
    • COMPLICATION.GOAL_PROGRESS_COLORS: uma lista de cores hexadecimais separada por espaços, por exemplo, #FF0000 #00FF00.
    • COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE: um booleano que especifica se as cores serão interpoladas.
  • WEIGHTED_ELEMENTS:
    • COMPLICATION.WEIGHTED_ELEMENTS_COLORS: uma lista de cores hexadecimais separada por espaços, por exemplo, #FF0000 #00FF00.
    • COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS: uma lista separada por espaços de pesos de elementos.
    • COMPLICATION.WEIGHTED_ELEMENTS_BACKGROUND_COLOR
    • COMPLICATION.TEXT
    • COMPLICATION.TITLE

Para uma demonstração completa, consulte o exemplo.

Introduzido no Wear OS 4.

Sintaxe

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

Exemplo

O exemplo a seguir mostra um complemento que contém componentes de imagem, título e texto:

<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>

Atributos

O elemento ComplicationSlot precisa conter um atributo type. O elemento será renderizado se o usuário escolher um tipo de complemento correspondente. Os valores aceitos são SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE e EMPTY

Elementos internos

O elemento Complication pode conter qualquer número dos seguintes elementos internos: