Complicazione

Uno slot per le 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 viene visualizzata la complicazione per diversi tipi di complicazioni 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 la dimensione e la posizione dell'elemento.
slotId
Un identificatore numerico univoco dell'area annuncio.
supportedTypes
Un elenco dei tipi di complicazioni supportati che possono essere inseriti nello 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 su cui ruota l'elemento. Entrambi i valori sono numeri in virgola mobile scalati per rientrare nell'intervallo $ [0, 1] $.
angle
Un numero di gradi, in senso orario, per cui l'elemento deve essere ruotato attorno al suo punto di rotazione.
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 scalabilità orizzontale da applicare a questo elemento.
scaleY
Il fattore di scala verticale da applicare a questo elemento.
tintColor
Applica all'elemento un filtro di colore per la 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, che viene visualizzato nell'editor dei quadranti.
isCustomizable
Consente di stabilire 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 Compplication per ogni tipo di complicazione supportato. Facoltativamente, un elemento ComplicationSlot può contenere più elementi Compplication per supportare il cambiamento di aspetto con gli elementi Variant.

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