Una complicazione è qualsiasi funzionalità visualizzata su un quadrante oltre all'ora. Ad esempio, un indicatore della batteria è una complicazione. L'API Complications è destinata sia ai quadranti sia alle app di origine dati.
Il resto del documento descrive le origini dati, i quadranti e i tipi di complicazioni.
Origine dati complicazione
Le app che forniscono dati come livello della batteria, meteo o numero di passi per visualizzare i quadranti in caso di complicazioni sono chiamate origini dati delle complicazioni. Queste origini dati forniscono dati non elaborati e non sono responsabili del controllo del modo in cui i dati vengono visualizzati su un quadrante. Per scoprire di più sulla scrittura di app che forniscono dati ai quadranti, consulta Esposizione dei dati per complicazioni.
Il seguente diagramma mostra in che modo Wear OS by Google media il flusso di dati dalle origini ai quadranti.
![Flusso di dati delle complicazioni Flusso di dati delle complicazioni](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=9&hl=it)
Complicazioni sui quadranti
I quadranti ricevono dati da origini dati delle complicazioni, il che consente loro di includere complicazioni senza bisogno di codice per ottenere i dati sottostanti. I quadranti mantengono il controllo su come vengono visualizzati i dati, in modo da integrarli naturalmente nel loro design. Per maggiori informazioni, consulta la guida alla progettazione relativa alle complicazioni.
Per informazioni su come aggiungere complicazioni a un quadrante, consulta l'articolo Aggiungere complicazioni a un quadrante.
Tipi di complicazioni
I tipi di complicazioni definiscono i tipi di dati che possono essere visualizzati in una complicazione o forniti da un'origine dati. Ad esempio, utilizza il tipo SHORT_TEXT
quando i dati sono costituiti principalmente da una stringa breve. Un oggetto
ComplicationData
ha sempre un singolo
tipo di complicazione che definisce i campi obbligatori e facoltativi. Un campo obbligatorio rappresenta il dato principale e la maggior parte dei tipi prende il nome dal campo obbligatorio.
Le origini dati utilizzano i tipi di complicazioni in modo diverso rispetto ai quadranti:
- Un'origine dati sceglie i tipi di dati di complicazione da fornire, compresi i campi facoltativi di questi tipi da fornire e quanti tipi diversi possono essere supportati. Ad esempio, un'origine per il conteggio dei passaggi potrebbe supportare i tipi
RANGED_VALUE
eSHORT_TEXT
, mentre un'origine della riunione successiva potrebbe supportare i tipiSHORT_TEXT
eLONG_TEXT
. - Puoi scegliere quante complicazioni includere nel quadrante
e i tipi di complicazioni
da supportare. Ad esempio, una complicazione del quadrante su un quadrante potrebbe supportare i tipi
SHORT_TEXT
,ICON
eRANGED_VALUE
. Un indicatore sul quadrante potrebbe supportare solo il tipoRANGED_VALUE
.
Per scoprire di più sui diversi tipi di complicazioni e sui campi supportati da ciascun tipo, vedi Tipi di complicazioni.