Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Figura 1. Il flusso dei dati relativi alle complicazioni.
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.
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 e SHORT_TEXT, mentre un'origine della riunione successiva potrebbe supportare i tipi SHORT_TEXT e LONG_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 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, vedi
Tipi di complicazioni.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# About complications\n\nA\n[complication](https://en.wikipedia.org/wiki/Complication_(horology))\nis any feature that is displayed on a watch face in addition to the time.\nFor example, a battery\nindicator is a complication. The\n[Complications API](/reference/kotlin/androidx/wear/watchface/complications/package-summary)\nis for both watch faces and data source apps.\n\n\nThe rest of this document describes data sources, watch faces, and\ncomplication types.\n\nComplication data source\n------------------------\n\nApps that provide data such as\nbattery level, weather, or step counts to watch faces for\ncomplications are called *complication data sources* . These data\nsources supply raw data\nand are not responsible for controlling how their data is rendered on a\nwatch face.\nTo learn about writing apps that provide data to watch faces, see\n[Expose data to\ncomplications](/training/wearables/exposing-data-complications).\n\nThe following diagram shows how Wear OS by Google mediates the flow of data\nfrom sources to watch faces.\n**Figure 1.** The flow of complication data.\n\nComplications on watch faces\n----------------------------\n\nWatch faces receive data from complication data sources, which lets them\ninclude\ncomplications without needing code for getting the underlying data. Watch\nfaces retain\ncontrol over how the data is rendered, so they can integrate data\nnaturally with their\ndesign. For more information, see the design guide about\n[Complications](/training/wearables/design/complications).\n\nTo learn how to add complications to a watch face, see\n[Add complications to a watch face](/training/wearables/watch-faces/adding-complications).\n\nComplication types\n------------------\n\nComplication types define what kinds of data can be shown in a\ncomplication or supplied by\na data source. For example, use the `SHORT_TEXT` type when the\ndata consists\nprimarily of a short string. A\n[`ComplicationData`](/reference/androidx/wear/watchface/complications/data/ComplicationData) object always has a single\ncomplication type that defines required and optional fields. A required\nfield\nrepresents the primary piece of data; most types take their name from\nthe required field.\n\nData sources use complication types differently from watch faces:\n\n- A data source chooses the types of complication data to supply, including which optional fields of those types to supply, and how many different types can be supported. For example, a step-count source might support the `RANGED_VALUE` and `SHORT_TEXT` types, and a next-meeting source might support the `SHORT_TEXT` and `LONG_TEXT` types.\n- You can choose how many complications to include in your watch face and the complication types to support. For example, a dial complication on a watch face might support the `SHORT_TEXT`, `ICON`, and `RANGED_VALUE` types. A gauge on the watch face might support only the `RANGED_VALUE` type.\n\nTo learn more about different complication types and fields supported by\neach type, see\n[Complication types](/training/wearables/watch-faces/adding-complications#types-fields)."]]
