ComplicationSlot

Un emplacement de complication est une zone du cadran qu'un utilisateur peut ajouter dans l'interface de la complication. Les emplacements de complication contiennent des éléments de complication, qui définissent l'affichage pour différents types de complications et dans différents modes de cadran.

Introduit dans Wear OS 4.

Syntaxe

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

Attributs

ComplicationSlot présente les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

x, y, width, height
Ensemble d'entiers qui spécifient la taille et la position de l'élément.
slotId
Identifiant numérique unique de l'emplacement.
supportedTypes
Liste des types de complications compatibles pouvant remplir l'emplacement. Les valeurs acceptées sont SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE et EMPTY. Vous pouvez utiliser plusieurs types de complications en les séparant par un espace (par exemple, SHORT_TEXT RANGED_VALUE).

Attributs facultatifs

Les attributs suivants sont facultatifs :

pivotX, pivotY
Point pivot bidimensionnel autour duquel l'élément pivote. Les deux valeurs sont des nombres à virgule flottante qui sont ajustés pour tenir dans la plage $ [0, 1] $.
angle
Un certain nombre de degrés de rotation de l'élément autour de son point pivot (dans le sens des aiguilles d'une montre).
alpha
Définissez le niveau de transparence à appliquer à cet élément. La valeur 0 indique que l'élément doit être totalement transparent. La valeur 255 indique que l'élément doit être complètement opaque.
scaleX
Facteur de scaling horizontal à appliquer à cet élément.
scaleY
Facteur de scaling vertical à appliquer à cet élément.
tintColor
Appliquez un filtre de couleur (teinte) à l'élément. Vous devez spécifier la couleur au format ARVB (#ff000000 = noir opaque) ou au format RVB (#000000 = noir).
displayName
ID de ressource correspondant à un nom localisé pour l'emplacement de la complication, qui s'affiche dans l'éditeur de cadran.
isCustomizable
Détermine si un utilisateur peut modifier le fournisseur de cet emplacement dans l'éditeur de cadran. La valeur par défaut est TRUE.

Éléments internes

L'élément ComplicationSlot doit contenir exactement un seul élément Zone de délimitation.

Un élément ComplicationSlot doit contenir au moins un élément Complication pour chaque type de complication compatible. Un élément ComplicationSlot peut éventuellement contenir plus d'éléments Complication pour permettre la modification de l'apparence avec les éléments Variant.

L'élément ComplicationSlot peut également contenir les éléments internes suivants :