Steckplatz für Zusatzfunktionen

Ein Zusatzbereich ist ein Bereich des Zifferblatts, in dem der Nutzer eine Zusatzfunktion hinzufügen kann. Zusatzfunktionsslots enthalten Zusatzfunktionselemente, die festlegen, wie die Zusatzfunktion für verschiedene Zusatzfunktionstypen und in verschiedenen Watch-Face-Modi gerendert wird.

In Wear OS 4 eingeführt.

Syntax

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Attribute

ComplicationSlot hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

x, y, width, height
Eine Sammlung von Ganzzahlen, die die Größe und Position des Elements angeben.
slotId
Eine eindeutige numerische Kennung für den Steckplatz.
supportedTypes
Eine Liste der unterstützten Komplikationstypen, die in den Slot eingefügt werden können. Unterstützte Werte sind SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE und EMPTY. Es können mehrere Zusatzfunktionen unterstützt werden, indem Sie sie durch ein Leerzeichen voneinander trennen (z. B. SHORT_TEXT RANGED_VALUE).

Optionale Attribute

Die folgenden Attribute sind optional:

pivotX, pivotY
Ein zweidimensionaler Drehpunkt, um den sich das Element dreht. Beide Werte sind Gleitkommazahlen, die so skaliert sind, dass sie in den Bereich $ [0, 1] $ passen.
angle
Die Anzahl der Grad, um die das Element im Uhrzeigersinn um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie die Transparenz dieses Elements fest. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Ein Wert von 255 gibt an, dass das Element vollständig undurchsichtig sein soll.
scaleX
Der horizontale Skalierungsfaktor, der auf dieses Element angewendet werden soll.
scaleY
Der vertikale Skalierungsfaktor, der auf dieses Element angewendet werden soll.
tintColor
Wenden Sie einen Farbtonfilter auf das Element an. Sie müssen die Farbe entweder im ARGB-Format (#ff000000 = opakes Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.
displayName
Eine Ressourcen-ID, die einem lokalisierten Namen für den Zusatzfunktions-Slot entspricht, der im Zifferblatteditor angezeigt wird.
isCustomizable
Bestimmt, ob ein Nutzer den Anbieter für diesen Slot im Zifferblatteditor ändern kann. Die Standardeinstellung ist TRUE.

Innere Elemente

Das ComplicationSlot-Element muss genau ein Bounding Area-Element enthalten.

Ein ComplicationSlot-Element muss mindestens ein Complication-Element pro unterstützten Zusatztyp enthalten. Ein ComplicationSlot-Element kann optional weitere Komplikationen enthalten, um das Erscheinungsbild mit Varianten zu ändern.

Das ComplicationSlot-Element kann auch die folgenden inneren Elemente enthalten:

  • Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
  • PartImage
  • PartText