Informazioni sulle complicazioni

Per complicazione si intende 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.

La parte restante di questo documento descrive le origini dati, i quadranti e i tipi di complicazioni.

Origine dati della complicazione

Le app che forniscono dati come il livello 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 scoprire come scrivere app che forniscono dati ai quadranti, consulta Esporre i dati alle complicazioni.

Il seguente diagramma mostra in che modo Wear OS by Google gestisce il flusso di dati dalle origini ai quadranti.

Complicazioni sui quadranti

I quadranti ricevono dati dalle origini dati delle complicazioni, il che consente loro di includere complicazioni senza la necessità 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 al design sulle complicazioni.

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

Tipi di complicazioni

I tipi di complicazioni definiscono i tipi di dati che 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 ComplicationData oggetto ha sempre un singolo 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 complicazioni 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 del conteggio dei passi potrebbe supportare i tipi RANGED_VALUE e SHORT_TEXT, mentre un'origine del 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 del quadrante su un quadrante potrebbe supportare i tipi SHORT_TEXT, SMALL_IMAGE e RANGED_VALUE. Un indicatore sul quadrante potrebbe supportare solo il RANGED_VALUE tipo.

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