Aggiungere complicazioni a un quadrante

Una complicazione del quadrante mostra i dati di un'origine dati. Utilizzando il formato del quadrante, puoi scegliere le origini dati per ottenere i dati sottostanti. In questo modo i quadranti possono visualizzare informazioni oltre l'ora del giorno 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 sul quadrante di ogni complicazione.

Per maggiori informazioni, dai un'occhiata all'esempio di WatchFaceFormat su GitHub.

Tipi e campi

Nella tabella seguente vengono descritti i tipi e i campi del 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 una sola icona o un solo titolo breve se vengono forniti uno o entrambi.
MONOCHROMATIC_IMAGE	Immagine monocromatica	Icona di protezione dal burn-in Descrizione dei contenuti	Utilizzato quando il testo non è necessario. L'icona deve essere monocolore e potrebbe essere colorata dal quadrante.
RANGED_VALUE	Valore Valore min Valore max	Immagine monocromatica Icona di protezione anti-burn-in Testo breve Titolo breve Scala 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 a elementi come il conteggio dei passi in cui inizia il valore a zero e può superare il valore target.
LONG_TEXT	Testo lungo	Titolo lungo Immagine monocromatica Icona di protezione anti-burn-in Immagine piccola Descrizione dei contenuti	Mostra il titolo lungo, se presente.
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 è attiva la protezione dal burn-in o la modalità Ambient a bassa bit è attiva, il quadrante potrebbe usare l'immagine piccola della protezione dal burn-in perché è sicuro. Altrimenti, perché è difficile per un orologio volto per determinare l'idoneità, un'immagine non viene visualizzata.
LARGE_IMAGE	Immagine grande	Descrizione dei contenuti	L'immagine deve essere abbastanza grande da riempire il quadrante. La variabilità delle immagini può risultare in un'immagine non adatta per la visualizzazione in modalità Ambient su dispositivi con protezione dal burn-in o con velocità bassa modalità Ambient. 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). La dimensione dell'elemento quando viene visualizzato deve essere proporzionale 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 può essere inviato per qualsiasi spazio per le complicazioni. Questi tipi non hanno campi e non devono essere inclusi in un elenco di tipi supportati. Questi tipi abilitano l'orologio volti per differenziare 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 fonti non possono inviare TYPE_EMPTY in risposta a 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 un 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 o quando il quadrante sceglie nessuna origine e questo tipo di complicazione come predefinito. Non può essere inviato dalle origini.
TYPE_NO_DATA	Inviata dal sistema quando una complicazione ha un'origine si attiva per eliminare la complicazione prima della ricezione dei dati effettivi dall'origine. Possono essere inviati dalle origini se non hanno dati effettivi da inviare.

Su alcuni dispositivi, i quadranti e le complicazioni devono usare Watch Face Format

Se il quadrante esistente utilizza la raccolta di quadranti Jetpack o la Libreria di assistenza indossabile, gli utenti continuano a vedere 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 tuo quadrante attuale utilizza la raccolta di quadranti Jetpack o la libreria di supporto per gli indossabili ed è installato su uno di questi dispositivi, quadrante può continuare a ricevere aggiornamenti.

Tuttavia, sui nuovi smartwatch lanciati con Wear OS 5, i quadranti devono utilizzare Watch Face Format. Per questo motivo, ti consigliamo di eseguire la migrazione all'utilizzo del formato del quadrante.