Aggiungere complicazioni a un quadrante

Una complicazione del quadrante mostra i dati di un'origine dati. Con Formato quadrante, 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 ti 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, consulta l'esempio 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.

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 di un unico colore e potrebbe essere colorata dal quadrante.
RANGED_VALUE	Valore Valore minimo Valore massimo	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 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 di protezione anti-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 è attivata la protezione anti-burn-in o la modalità Ambient a bassa risoluzione, 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	L'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). 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 ponderati.

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 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 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 libreria Wearable Support, 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 Jetpack Watch Face o la Wearable Support Library ed è installato su uno di questi dispositivi, 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.