Steckplatz für Zusatzfunktionen

Ein Bereich für Zusatzfunktionen ist ein Bereich auf dem Zifferblatt, der vom Nutzer hinzugefügt werden kann. Zusatzfunktionen enthalten Elemente des Typs Zusatzfunktion, mit denen festgelegt wird, wie die Zusatzfunktion für verschiedene Zusatzfunktionen und in verschiedenen Zifferblattmodi gerendert wird.

Eingeführt in Wear OS 4.

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

Merkmale

Der 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 die Anzeigenfläche.
supportedTypes
Eine Liste der unterstützten Zusatzfunktionen, die den Slot füllen können. Unterstützte Werte sind SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE und EMPTY. Sie können mehrere Komplikationstypen unterstützen. Trennen Sie sie dazu durch ein Leerzeichen (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 werden, dass sie in den Bereich $ [0, 1] $ passen.
angle
Eine Anzahl von Grad im Uhrzeigersinn, um die das Element um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie fest, wie transparent dieses Element sein soll. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Der Wert 255 gibt an, dass das Element vollständig deckend 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 Farbfilter 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 Erweiterungsslot entspricht, der im Zifferblatt-Editor angezeigt wird.
isCustomizable
Bestimmt, ob ein Nutzer den Anbieter für diesen Slot im Zifferblatt-Editor ändern kann. Die Standardeinstellung ist TRUE.

Innere Elemente

Das Element ComplicationSlot muss genau ein Element Begrenzungsbereich enthalten.

Ein ComplicationSlot-Element muss für jeden unterstützten Zusatztyp mindestens ein Complication-Element enthalten. Ein ComplicationSlot-Element kann optional weitere Complication-Elemente enthalten, um das Ändern der Darstellung mit Variant-Elementen zu unterstützen.

Das ComplicationSlot-Element kann auch die folgenden Elemente im Inneren enthalten: