Complicazione

Uno slot per complicazioni è un'area del quadrante che può essere aggiunta dall'utente. Gli slot delle complicazioni contengono elementi di Complicazione che definiscono il modo in cui la complicazione viene visualizzata per diversi tipi di complicazione e in diverse modalità del quadrante.

Introdotta in Wear OS 4.

Sintassi

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

Attributi

ComplicationSlot ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

x, y, width, height
Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.
slotId
Un identificatore numerico univoco per l'area annuncio.
supportedTypes
Un elenco dei tipi di complicazioni supportati che possono completare lo slot. I valori supportati sono SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE e EMPTY. È possibile supportare più tipi di complicazioni separandoli con uno spazio (ad esempio, SHORT_TEXT RANGED_VALUE).

Attributi facoltativi

I seguenti attributi sono facoltativi:

pivotX, pivotY
Un punto pivot bidimensionale rispetto al quale l'elemento ruota. Entrambi i valori sono numeri in virgola mobile che vengono ridimensionati per rientrare nell'intervallo $ [0, 1] $.
angle
Un numero di gradi, in senso orario, in cui l'elemento deve essere ruotato attorno al suo punto di pivot.
alpha
Imposta il livello di trasparenza che questo elemento deve avere. Il valore 0 indica che l'elemento deve essere completamente trasparente. Il valore 255 indica che l'elemento deve essere completamente opaco.
scaleX
Il fattore di ridimensionamento orizzontale da applicare a questo elemento.
scaleY
Il fattore di ridimensionamento verticale da applicare a questo elemento.
tintColor
Applica all'elemento un filtro di colore di tinta. Devi specificare il colore utilizzando il formato ARGB (#ff000000 = nero opaco) o il formato RGB (#000000 = nero).
displayName
Un ID risorsa corrispondente a un nome localizzato per lo slot della complicazione, visualizzato nell'editor del quadrante.
isCustomizable
Determina se un utente può cambiare il fornitore per questo slot nell'editor dei quadranti. Il valore predefinito è TRUE.

Elementi interni

L'elemento ComplicationSlot deve contenere esattamente un elemento Bounding Area.

Un elemento ComplicationSlot deve contenere almeno un elemento Complicazione per tipo di complicazione supportato. Facoltativamente, un elemento ComplicationSlot può contenere più elementi Complicazione per supportare il cambiamento dell'aspetto con gli elementi Variant.

L'elemento ComplicationSlot può anche contenere i seguenti elementi interni: