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 quadranti possono mostrare informazioni diverse dall'ora senza bisogno di codice per recuperare i dati.

Utilizzare il formato del quadrante

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 sul quadrante in cui viene visualizzata ogni complicazione.

Per maggiori informazioni, consulta l'esempio 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 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.





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

 Mostra solo un'icona o un titolo breve se vengono forniti uno o entrambi i tipi.
MONOCHROMATIC_IMAGE Immagine monocromatica
 Icona della protezione dal burn-in
Descrizione dei contenuti

 Utilizzato quando non è necessario testo. L'icona deve essere di un unico colore 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 metodo isRangedValueProgressHidden() per nascondere la barra di avanzamento fornita dalla classe ComplicationDrawable.
GOAL_PROGRESS Valore
Valore target
 Immagine monocromatica
Icona di protezione anti-burn-in
Testo breve
Titolo breve
Scala di colori
Valore dinamico
Descrizione dei contenuti

 GOAL_PROGRESS è destinato ad aspetti 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 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 fotografico o stile icona. Lo stile della foto indica che deve riempire lo spazio e può essere ritagliata. Lo stile dell'icona indica che non può essere ritagliata e può essere allineata. La variabilità dell'immagine può comportare un'immagine non adatta alla visualizzazione in modalità Ambient sui dispositivi con protezione anti-burn-in o con modalità Ambient a bassa profondità di colore. Quando sono abilitate la protezione dal burn-in o la modalità Ambient a bassa bit, 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à, non viene visualizzata alcuna immagine.
LARGE_IMAGE Immagine grande
 Descrizione dei contenuti
 Questa immagine deve 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 anti-burn-in o con modalità Ambient a bassa profondità di colore. Poiché è difficile per un quadrante determinare la idoneità alla visualizzazione, un quadrante non mostra un'immagine in modalità Ambient se è attiva la protezione dal burn-in o la modalità Ambient a basso bit.
WEIGHTED_ELEMENTS Elenco elementi
 Immagine monocromatica
Icona di protezione anti-burn-in
Testo breve
Titolo breve
Descrizione dei contenuti
 Ogni elemento è costituito da un colore e da un peso (maggiore di zero). Le dimensioni dell'elemento quando ne viene eseguito il rendering devono essere proporzionali al suo peso. La somma delle ponderazioni non deve necessariamente corrispondere a un valore specifico. Tieni presente che i quadranti possono ridipingere gli elementi con peso.

La tabella seguente descrive i tipi di complicazioni per i dati vuoti che possono essere inviati per qualsiasi spazio delle complicazioni. 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 una fascia oraria
  • Un'origine 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 Inviata dal sistema quando si attiva una complicazione, ma l'utente non ha selezionato un'origine e non è stato impostato alcun valore predefinito.

Non può essere inviato dalle origini.

TYPE_EMPTY Inviata dal sistema quando si attiva una complicazione e l'utente sceglie "Vuoto" anziché un'origine oppure quando il quadrante non sceglie un'origine e questo tipo di complicazione come predefinito.

Non può essere inviato dalle origini.

TYPE_NO_DATA Inviata dal sistema quando si attiva una complicazione che ha una sorgente per cancellarla prima che i dati effettivi vengano ricevuti dalla sorgente.

Possono essere inviati 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 Wearable Support Library, gli utenti continueranno a visualizzare i dati di tutte le origini nei dati delle 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 di quadranti Jetpack o la libreria di supporto per indossabili 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 formato Watch Face. Per questo motivo, ti consigliamo di eseguire la migrazione all'utilizzo del formato del quadrante.