Informazioni sulle complicazioni

Una complicazione è qualsiasi funzionalità visualizzata su un quadrante oltre all'ora. Ad esempio, un indicatore della batteria è una complicazione. L'API Complicazioni è destinata sia ai quadranti che alle app di origine dati.

Il resto di questo documento descrive le origini dati, i quadranti e i tipi di complicazione.

Origine dati delle complicazioni

Le app che forniscono dati come il livello della batteria, il meteo o il numero di passi ai quadranti per le complicazioni sono chiamate origini dati delle complicazioni. Queste origini dati forniscono dati non elaborati e non sono responsabili del controllo della modalità di rendering dei dati su un quadrante. Per informazioni sulla scrittura di app che forniscono dati ai quadranti, vedi Mostrare dati nelle complicazioni.

Il seguente diagramma mostra come Wear OS by Google gestisce il flusso di dati dalle fonti ai quadranti.

Figura 1. Il flusso di dati delle complicazioni.

Complicazioni sui quadranti

I quadranti ricevono dati dalle 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 sulla modalità di rendering dei dati, in modo da poterli integrare in modo naturale con il loro design. Per ulteriori informazioni, consulta la guida alla progettazione relativa alle complicazioni.

Per scoprire come aggiungere complicazioni a un quadrante, consulta Aggiungere complicazioni a un quadrante.

Tipi di complicazioni

I tipi di complicazione definiscono quali tipi di dati possono essere mostrati 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 solo tipo di complicazione che definisce i campi obbligatori e facoltativi. Un campo obbligatorio rappresenta il dato principale; la maggior parte dei tipi prende il nome dal campo obbligatorio.

Le origini dati utilizzano i tipi di complicazione in modo diverso dai quadranti:

• Un'origine dati sceglie i tipi di dati delle complicazioni da fornire, inclusi i campi facoltativi di questi tipi da fornire e il numero di tipi diversi che possono essere supportati. Ad esempio, un'origine conteggio passi potrebbe supportare i tipi RANGED_VALUE e SHORT_TEXT, mentre un'origine prossimo incontro potrebbe supportare i tipi SHORT_TEXT e LONG_TEXT.
• Puoi scegliere il numero di complicazioni da includere nel quadrante e i tipi di complicazioni da supportare. Ad esempio, una complicazione a forma di quadrante su un quadrante potrebbe supportare i tipi SHORT_TEXT, SMALL_IMAGE e RANGED_VALUE. Un indicatore sul quadrante potrebbe supportare solo il tipo RANGED_VALUE.

Per scoprire di più sui diversi tipi di complicazioni e sui campi supportati da ciascun tipo, consulta Tipi di complicazioni.