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
undEMPTY
. 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 Wert255
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: