Zusatzfunktion

Ein Element für Zusatzfunktionen definiert, wie ein bestimmter Zusatzfunktionstyp auf dem Zifferblatt angezeigt wird.

Für jeden Typ von Zusatzfunktionen können Sie Folgendes in Ausdrücken verwenden. So können Sie auf die Daten zugreifen, die für die Zusatzfunktion bereitgestellt werden:

  • Alle Typen und 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]: eine durch Leerzeichen getrennte Liste von Hex-Farben, z. B. #FF0000 #00FF00
    • [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] – ein boolescher Wert, der angibt, ob Farben interpoliert werden sollen
  • 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]: entspricht den Ordinalwerten von SmallImageType
  • GOAL_PROGRESS:
    • [COMPLICATION.GOAL_PROGRESS_VALUE]
    • [COMPLICATION.GOAL_PROGRESS_TARGET_VALUE]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]
    • [COMPLICATION.GOAL_PROGRESS_COLORS]: eine durch Leerzeichen getrennte Liste von Hex-Farben, z. B. #FF0000 #00FF00
    • [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] – (ein boolescher Wert, der angibt, ob Farben interpoliert werden sollen)
  • WEIGHTED_ELEMENTS:
    • [COMPLICATION.WEIGHTED_ELEMENTS_COLORS]: eine durch Leerzeichen getrennte Liste von Hex-Farben, z. B. #FF0000 #00FF00
    • [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS]: (eine durch Leerzeichen getrennte Liste mit Elementgewichtungen)
    • [COMPLICATION.WEIGHTED_ELEMENTS_BACKGROUND_COLOR]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]

Eine vollständige Demonstration finden Sie im Beispiel.

Eingeführt in Wear OS 4.

Syntax

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

Beispiel

Das folgende Beispiel zeigt eine Zusatzfunktion, die Bild-, Titel- und Textkomponenten enthält:

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

Merkmale

Das ComplicationSlot-Element muss ein type-Attribut enthalten. Das Element wird gerendert, wenn der Nutzer einen passenden Zusatzfunktionstyp auswählt. Unterstützte Werte sind SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE und EMPTY

Innere Elemente

Das Complication-Element kann eine beliebige Anzahl der folgenden Elemente enthalten: