Una complicazione del quadrante mostra i dati di un'origine dati. Utilizzando il Watch Face Format, puoi scegliere le origini dati per ottenere i dati sottostanti. In questo modo, i quadranti possono visualizzare informazioni oltre all'ora del giorno senza bisogno di codice per ottenere i dati.
Utilizzare Watch Face Format
L'elemento Complication ti consente di definire fino a otto complicazioni all'interno
di un singolo quadrante. L'elemento ti consente anche di definire la posizione di ogni complicazione sul quadrante.
Per maggiori informazioni, consulta l'esempio di WatchFaceFormat su GitHub.
Tipi e campi
La tabella seguente descrive i tipi e i campi dell'
ComplicationData oggetto. Se un quadrante richiede un campo non valido per un tipo di complicazione, viene restituito un valore predefinito per il campo. Ad esempio, se un quadrante tenta di accedere a un campo LONG_TEXT in un tipo SHORT_TEXT, viene restituito il valore predefinito per il campo LONG_TEXT, ovvero null. Tieni presente che non è garantita la visualizzazione dei campi facoltativi.
| Tipo | Campi obbligatori | Campi facoltativi | Note |
|---|---|---|---|
SHORT_TEXT
|
Testo breve |
Icona Icona di protezione dal burn-in Titolo breve Descrizione dei contenuti |
Mostra una sola icona o un titolo breve se ne vengono forniti uno o entrambi. |
MONOCHROMATIC_IMAGE
|
Immagine monocromatica |
Icona di protezione dal burn-in Descrizione dei contenuti |
Utilizzato quando non è necessario il testo. L'icona deve essere monocolore e potrebbe essere colorata dal quadrante. |
RANGED_VALUE
|
Valore Valore minimo Valore massimo |
Immagine monocromatica Icona di protezione dal burn-in Testo breve Titolo breve Rampa di colori Valore dinamico Descrizione dei contenuti |
Se vuoi disegnare la tua barra di avanzamento, puoi utilizzare il
isRangedValueProgressHidden() metodo per nascondere la barra di avanzamento
fornita dalla
ComplicationDrawable classe.
|
GOAL_PROGRESS
|
Valore Valore target |
Immagine monocromatica Icona di protezione dal burn-in Testo breve Titolo breve Rampa di colori Valore dinamico Descrizione dei contenuti |
GOAL_PROGRESS è pensato per elementi come il conteggio dei passi, in cui il valore inizia da zero ed è consentito superare il valore target. |
LONG_TEXT
|
Testo lungo |
Titolo lungo Immagine monocromatica Icona di protezione dal burn-in Immagine piccola Descrizione dei contenuti |
Mostra il titolo lungo, se fornito. |
SMALL_IMAGE
|
Immagine piccola |
Descrizione dei contenuti |
Un'immagine piccola ha uno dei due stili: stile foto o stile icona. Lo stile foto significa che l'immagine deve riempire lo spazio e può essere
ritagliata. Lo stile icona significa che l'immagine non può essere ritagliata e può essere riempita.
La variabilità dell'immagine può comportare la visualizzazione di un'immagine non adatta
in modalità Ambient sui dispositivi con protezione dal burn-in o con modalità Ambient a basso bit
Quando la protezione dal burn-in o la modalità Ambient a basso bit è
attivata, il quadrante potrebbe utilizzare l'immagine piccola di protezione dal burn-in
perché è sicura. In caso contrario, poiché è difficile per un quadrante
determinare l'idoneità, non viene visualizzata un'immagine.
|
LARGE_IMAGE
|
Immagine grande |
Descrizione dei contenuti |
Questa immagine deve essere abbastanza grande da riempire il quadrante.
La variabilità dell'immagine può comportare la visualizzazione di un'immagine non adatta
in modalità Ambient sui dispositivi con protezione dal burn-in o con modalità Ambient a basso bit
Poiché è difficile per un quadrante determinare
l'idoneità alla visualizzazione,
un quadrante non visualizza un'immagine
in modalità Ambient se la protezione dal burn-in o la modalità Ambient a basso bit è attivata.
|
WEIGHTED_ELEMENTS
|
Elenco di elementi |
Immagine monocromatica Icona di protezione dal burn-in Testo breve Titolo breve Descrizione dei contenuti |
Ogni elemento è composto da un colore e un peso (maggiore di zero). La dimensione dell'elemento durante il rendering deve essere proporzionale al suo peso. Non è necessario che i pesi sommino un valore specifico. Tieni presente che i quadranti possono ricolorare WEIGHTED_ELEMENTS. |
La tabella seguente descrive i tipi di complicazione per i dati vuoti che possono essere inviati per qualsiasi spazio per la complicazione. Questi tipi non hanno campi e non devono essere inclusi in un elenco di tipi supportati. Questi tipi consentono ai quadranti di distinguere tra i seguenti tre casi:
- Non è stata scelta alcuna origine
- L'utente ha selezionato "vuoto" per uno slot
- Un'origine non ha dati da inviare
Le origini non possono inviare TYPE_EMPTY in risposta alle
richieste di aggiornamento. Invia invece TYPE_NO_DATA.
| Tipo di complicazione | Descrizione |
|---|---|
TYPE_NOT_CONFIGURED
|
Inviato dal sistema quando una complicazione si attiva, ma l'utente non ha
selezionato un'origine e non è stato impostato alcun valore predefinito.
Non può essere inviato dalle origini. |
TYPE_EMPTY
|
Inviato dal sistema quando una complicazione si attiva e l'utente
sceglie "vuoto" anziché un'origine oppure quando il quadrante
non sceglie alcuna origine e questo tipo di complicazione come predefinito.
Non può essere inviato dalle origini. |
TYPE_NO_DATA
|
Inviato dal sistema quando una complicazione con un'origine
si attiva per cancellare la complicazione prima che i dati effettivi vengano ricevuti
dall'origine.
Può essere inviato dalle origini se non hanno dati effettivi da inviare. |
Su alcuni dispositivi, i quadranti e le complicazioni devono utilizzare Watch Face Format
Se il quadrante esistente utilizza la libreria Jetpack Watch Face o la libreria Wearable Support, gli utenti continuano a visualizzare i dati di tutte le origini dati nelle complicazioni del quadrante sui seguenti dispositivi:
- Dispositivi con Wear OS 4 o versioni precedenti.
- Dispositivi che ricevono un upgrade OTA a Wear OS 5.
Inoltre, se il quadrante esistente utilizza la libreria Jetpack Watch Face o la libreria Support ed è installato su uno di questi dispositivi, il quadrante può continuare a ricevere aggiornamenti.
Tuttavia, sui nuovi smartwatch lanciati con Wear OS 5, i quadranti devono utilizzare il Watch Face Format. Per questo motivo, ti consigliamo di eseguire la migrazione all'utilizzo di Watch Face Format.
Consigliati per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Esposizione dei dati alle complicazioni del quadrante su Wear OS
- Complicazione
- DefaultProviderPolicy