Complicazioni
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Una complicazione è un elemento dell'interfaccia utente su un quadrante contenente informazioni facilmente consultabili
che gli utenti vogliono vedere spesso nell'arco della giornata. Ad esempio, puoi creare una complicazione del meteo attuale o del battito cardiaco.
Principi dell'UX
Le seguenti sezioni descrivono i principi da tenere a mente durante la creazione delle complicazioni.
A colpo d'occhio |
Avanti di contenuti |
La privacy prima di tutto |
| Le complicazioni sono piccoli componenti progettati per aiutare gli utenti a completare rapidamente attività frequenti. Rendi i contenuti semplici e leggibili. |
Le complicazioni sono più utili quando i contenuti di cui l'utente ha bisogno vengono resi visibili semplicemente sollevando il polso, senza richiedere ulteriori interazioni. |
Lo smartwatch viaggia con l'utente ovunque si trovi. Valuta se i contenuti delle complicazioni sono pertinenti al contesto dell'utente. |
Casi d'uso
Se toccate, le complicazioni possono aiutare gli utenti ad accedere a una parte specifica di un'app.
Possono anche eseguire un'azione autonoma. Ad esempio, toccando una complicazione di Conteggio acqua viene modificato il numero di vetri.
WearOS include automaticamente una complicazione per le scorciatoie app, quindi non è necessario crearne una nuova. Concentrati invece sulla creazione di complicazioni
che aiutano gli utenti a completare attività mirate.
Tipi
I tipi di complicazioni si riferiscono ai tipi di dati visualizzati nella complicazione o forniti da un'origine dati. Una complicazione ha sempre un solo tipo che include campi obbligatori e facoltativi. Un campo obbligatorio contiene i dati principali. La maggior parte dei tipi di complicazioni prende il nome dal campo obbligatorio. Puoi scegliere quante complicazioni includere nel quadrante e i tipi di complicazioni da supportare. Esistono cinque tipi di complicazioni.
| Tipo |
Campi obbligatori |
Campi facoltativi |
Nome corso |
Esempio |
| SHORT_TEXT |
Testo breve |
Icona,
Icona protezione brucia,
Titolo breve |
ShortTextComplicationData |
 |
| ICONA |
Icona |
Icona protezione brucia in profondità |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Valore
Valore minimo
Valore max |
Icona,
Icona di protezione Brucia,
Testo breve,
Titolo breve |
RangedValueComplicationData |
 |
| TESTO LUNGO |
Testo lungo |
Titolo lungo,
Icona,
Icona di protezione Brucia,
Immagine piccola |
LongTextComplicationData |
 |
| IMMAGINE_PICCOLA |
Immagine piccola |
|
SmallImageComplicationData |
 |
| IMMAGINE_GRANDE |
Immagine grande |
|
PhotoImageComplicationData |
 |
Per ulteriori informazioni sulle origini dati relative alle complicazioni, consulta
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.
[null,null,["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
