Aggiungere complicazioni a un quadrante

Una complicazione del quadrante mostra i dati di un'origine dati. Utilizzando il Formato quadrante, puoi scegliere le origini dati per ottenere i dati sottostanti. In questo modo, i quadranti dell'orologio possono visualizzare informazioni diverse dall'ora senza bisogno di codice per ottenere i dati.

Utilizzare Watch Face Format

L'elemento Complication 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'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 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 è garantito che i campi facoltativi vengano visualizzati.





Tipo Campi obbligatori Campi facoltativi Note
SHORT_TEXT Testo breve Icona
Icona di protezione dal burn-in
Titolo breve
Descrizione dei contenuti

 Mostra solo un'icona o un titolo breve se viene fornito 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 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 metodo isRangedValueProgressHidden() per nascondere la barra di avanzamento fornita dalla classe ComplicationDrawable.
GOAL_PROGRESS Valore
Valore target
 Immagine monocromatica
Icona di protezione 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 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 della foto prevede che riempia lo spazio e possa essere ritagliata. Lo stile dell'icona indica che non può essere ritagliata e può essere riempita. La variabilità dell'immagine può comportare un'immagine non adatta alla visualizzazione in modalità Ambient sui dispositivi con protezione dal burn-in o con modalità Ambient a bassa risoluzione. Quando la protezione anti-burn-in o la modalità Ambient a bassa risoluzione è attiva, il quadrante potrebbe utilizzare l'immagine piccola della protezione anti-burn-in perché è sicura. In caso contrario, poiché è difficile per un quadrante determinare l'idoneità, non viene visualizzata alcuna immagine.
LARGE_IMAGE Immagine grande
 Descrizione dei contenuti
 Questa immagine dovrebbe essere abbastanza grande da riempire il quadrante. La variabilità dell'immagine può comportare un'immagine non adatta alla visualizzazione in modalità Ambient sui dispositivi con protezione dal burn-in o con modalità Ambient a bassa risoluzione. Poiché è difficile per un quadrante determinare l'idoneità alla visualizzazione, un quadrante non mostra un'immagine in modalità Ambient se è attivata la protezione dal burn-in o la modalità Ambient a bassa risoluzione.
WEIGHTED_ELEMENTS Elenco degli elementi
 Immagine monocromatica
Icona di protezione burn-in
Testo breve
Titolo breve
Descrizione dei contenuti
 Ogni elemento è costituito da un colore e da un peso (maggiore di zero). La dimensione dell'elemento durante il rendering deve essere proporzionale al suo peso. Non è necessario che le ponderazioni raggiungano 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 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 distinguere tra i seguenti tre casi:

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

Le origini non possono inviare TYPE_EMPTY in risposta alle richieste di aggiornamento. Invia 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 fonti.

TYPE_EMPTY Inviato dal sistema quando una complicazione si attiva e l'utente sceglie "vuoto" anziché una fonte oppure quando il quadrante non sceglie alcuna fonte e questo tipo di complicazione come predefinito.

Non può essere inviato dalle fonti.

TYPE_NO_DATA Inviato dal sistema quando una complicazione con una sorgente si attiva per cancellare la complicazione prima che i dati effettivi vengano ricevuti dalla sorgente.

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 Wearable Support Library 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 usare il Watch Face Format. Per questo motivo, ti consigliamo di eseguire la migrazione all'utilizzo del formato del quadrante.