Zusatzfunktion

Mit einem Zusatzinformationselement wird festgelegt, wie eine bestimmte Zusatzfunktion auf dem Zifferblatt angezeigt wird.

Für jeden Typ der Zusatzfunktion können Sie Folgendes in Ausdrücken verwenden: So können Sie auf die Daten zugreifen, die der Zusatzfunktion zur Verfügung gestellt 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 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 von Elementgewichtungen
    • [COMPLICATION.WEIGHTED_ELEMENTS_BACKGROUND_COLOR]
    • [COMPLICATION.TEXT]
    • [COMPLICATION.TITLE]

Eine vollständige Demonstration finden Sie im Beispiel.

Mit Wear OS 4 eingeführt.

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 eine passende Zusatzfunktion auswählt. Unterstützte Werte sind SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE und EMPTY.

Innere Elemente

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