Complicazione

Versione del formato del quadrante Versione 3 Versione 2 Versione 1

---

Una posizione della complicazione è un'area del quadrante in cui l'utente può aggiungere una complicazione. Gli slot delle complicazioni contengono elementi Complication, che definiscono il modo in cui la complicazione viene visualizzata per diversi tipi di complicazione e in diverse modalità del quadrante.

Nota: un quadrante può avere al massimo otto istanze di ComplicationSlot, total.

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 la posizione

.

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 es. SHORT_TEXT RANGED_VALUE).

Attributi facoltativi

I seguenti attributi sono facoltativi:

pivotX, pivotY

Un punto di rotazione bidimensionale attorno al quale ruota l'elemento. Entrambi i valori sono numeri a virgola mobile che vengono scalati in modo da rientrare nell'intervallo $ [0, 1] $.

angle

Il numero di gradi in senso orario di cui ruotare l'elemento attorno al suo centro di rotazione.

alpha

Imposta il livello di trasparenza che deve avere questo elemento. Un valore 0 indica che l'elemento deve essere completamente trasparente. Un valore 255 indica che l'elemento deve essere completamente opaco.

scaleX

Il fattore di scala orizzontale da applicare a questo elemento.

scaleY

Il fattore di scalabilità verticale da applicare a questo elemento.

tintColor

Applica un filtro di tinta all'elemento. 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 l'area della complicazione, visualizzato nell'editor del quadrante.

isCustomizable

Determina se un utente può modificare il fornitore per questo slot nell'editor del quadrante. Il valore predefinito è TRUE.

Elementi interni

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

Un elemento ComplicationSlot deve contenere almeno un elemento Complication per ogni tipo di complicazione supportato. Un elemento ComplicationSlot può facoltativamente contenere altri elementi Complication per supportare la modifica dell'aspetto con gli elementi Variant.

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

• DefaultProviderPolicy
• Variant
• ScreenReader