Aggiungere complicazioni a un quadrante

Una complicazione del quadrante mostra i dati di un'origine dati. Utilizzando Watch Face Format, puoi scegliere le origini dati per ottenere i dati sottostanti. In questo modo, i tuoi quadranti possono mostrare informazioni oltre l'ora del giorno senza bisogno di codice per ottenere i dati.

Usa il formato del quadrante

L'elemento Complication consente di definire fino a otto complicazioni in un singolo quadrante. Inoltre, permette di definire la posizione sul quadrante di ogni complicazione.

Per ulteriori informazioni, guarda l'esempio di WatchFaceFormat su GitHub.

Tipi e campi

La seguente tabella descrive i tipi e i campi dell'oggetto ComplicationData. 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 prova ad accedere a un campo LONG_TEXT in un tipo SHORT_TEXT, viene restituito il valore predefinito del campo LONG_TEXT, null. Non è garantito che i campi facoltativi vengano visualizzati.





Tipo Campi obbligatori Campi facoltativi Notes
SHORT_TEXT Testo breve Icona
Icona Protezione dal burn-in
Titolo breve
Descrizione dei contenuti

 Mostra solo un'icona o un titolo breve se ne viene fornita una o entrambe.
MONOCHROMATIC_IMAGE Immagine monocromatica
 Icona protezione burn-in
Descrizione dei contenuti

 Da utilizzare quando il testo non è necessario. L'icona deve essere di un solo colore e potrebbe essere colorata in base al quadrante.
RANGED_VALUE Valore
Valore minimo
Valore massimo
 Immagine monocromatica
Icona protezione dal burn-in
Testo breve
Titolo breve
Adeguamento colore
Valore dinamico
Descrizione dei contenuti

 Se vuoi tracciare una barra di avanzamento personalizzata, puoi utilizzare il metodo isRangedValueProgressHidden() per nascondere la barra di avanzamento fornita dalla classe ComplicationDrawable.
GOAL_PROGRESS Valore
Valore target
 Immagine monocromatica
Icona protezione dal burn-in
Testo breve
Titolo breve
Adeguamento colore
Valore dinamico
Descrizione dei contenuti

 GOAL_PROGRESS è destinato ad esempio al conteggio dei passi in cui il valore inizia da zero e può 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 disponibili: stile foto o stile icona. Lo stile della foto indica che dovrebbe occupare lo spazio e può essere ritagliato. Lo stile dell'icona indica che non può essere ritagliata e può essere riempita. La variabilità delle immagini può rendere l'immagine non adatta per la visualizzazione in modalità Ambient su 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 è abilitata, il quadrante potrebbe utilizzare l'immagine piccola della protezione dal burn-in perché è sicura. In caso contrario, poiché è difficile per un quadrante determinare l'idoneità, l'immagine non viene visualizzata.
LARGE_IMAGE Immagine grande
 Descrizione dei contenuti
 Questa immagine dovrebbe essere abbastanza grande da riempire il quadrante. La variabilità delle immagini può rendere l'immagine non adatta per la visualizzazione in modalità Ambient su dispositivi con protezione dal burn-in o con modalità Ambient a basso bit. Poiché è difficile per un quadrante determinare l'idoneità per il display, un quadrante non mostra un'immagine in modalità Ambient se sono attivi la protezione dal burn-in o la modalità Ambient a basso bit.
WEIGHTED_ELEMENTS Elenco degli elementi
 Immagine monocromatica
Icona protezione dal burn-in
Testo breve
Titolo breve
Descrizione dei contenuti
 Ogni elemento è costituito da un colore e da una ponderazione (maggiore di zero). Le dimensioni dell'elemento quando viene eseguito il rendering devono essere proporzionali alla sua ponderazione. Non è necessario sommare le ponderazioni a un valore specifico. Tieni presente che i quadranti possono ricolorare WEIGHTED_ELEMENTS.

La tabella seguente descrive i tipi di complicazioni per i dati vuoti che possono essere inviati per qualsiasi slot di complicazione. Questi tipi non hanno campi e non devono essere inclusi in un elenco di tipi supportati. Questi tipi consentono ai quadranti di distinguersi tra i tre casi seguenti:

  • Nessuna origine scelta
  • L'utente ha selezionato "vuoto" per uno slot
  • Un'origine non ha dati da inviare

Le origini non possono inviare TYPE_EMPTY in risposta a richieste di aggiornamento. Invia invece TYPE_NO_DATA.

Tipo di complicazione Descrizione
TYPE_NOT_CONFIGURED Inviato dal sistema quando viene attivata una complicazione, ma l'utente non ha selezionato un'origine e non è stata impostata nessuna origine.

Non può essere inviato dalle origini.

TYPE_EMPTY Inviato dal sistema quando viene attivata una complicazione e l'utente sceglie "vuota" invece di 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 Inviata dal sistema quando una complicazione che ha un'origine si attiva per cancellarla prima che i dati effettivi vengano ricevuti dall'origine.

Possono essere inviati dalle origini se non hanno dati effettivi da inviare.

La maggior parte delle origini dati richiede il formato del quadrante orologio

Per mantenere l'aspetto delle complicazioni del quadrante nelle prossime release di Wear OS, devi utilizzare Watch Face Format. Se il quadrante utilizza invece la libreria dei quadranti Jetpack o la libreria di supporto indossabile, le versioni più recenti di Wear OS non mostreranno i dati della maggior parte delle origini dati nelle complicazioni dei quadranti.

Per preservare completamente l'aspetto delle complicazioni nei quadranti che non utilizzano Watch Face Format, i quadranti devono utilizzare una delle seguenti origini dati negli slot delle complicazioni:

A seconda del produttore del dispositivo, potrebbero essere visibili alcune fonti di complicazioni aggiuntive sui quadranti che non utilizzano questo formato.