Quali dati può mostrare un quadrante Connect IQ? Le complicazioni spiegate
Un quadrante Connect IQ può mostrare ciò che l'API di Garmin gli passa: i valori dei moduli propri dell'orologio e, dal livello API 4.2.0, valori di sistema chiamati complicazioni (complications). L'SDK 9.3.0 documenta 42 tipi di complicazione, tra cui la distanza settimanale di corsa e bici, lo stato dell'allenamento e il punteggio del sonno; lo stato HRV e la Training Readiness non ci sono.
Cos'è una complicazione
Una complicazione è un valore che il sistema dell'orologio pubblica e a cui un quadrante può abbonarsi. Garmin descrive il modulo come quello che permette alle app di abbonarsi alle complicazioni e di pubblicarle, e un quadrante può registrare una funzione di callback e abbonarsi a più complicazioni (Complications API, verificato il 9 novembre 2026). Il quadrante riceve quindi il nuovo valore ogni volta che cambia, invece di calcolarlo. Gli abbonamenti non sopravvivono a un riavvio del quadrante e vengono impostati di nuovo a ogni avvio; un tipo che l'orologio non ha mostra -- invece di un numero, come descritto in perché un quadrante mostra --.
Quale valore da quale livello API
Quasi tutti i tipi arrivano con il livello API 4.2.0; tre sono arrivati dopo.
| Livello API | Tipi di complicazione |
|---|---|
| 4.2.0 | batteria, passi, calorie, piani saliti, minuti di intensità, data, meteo attuale e previsioni, eventi del calendario, alba e tramonto, altitudine, pressione al livello del mare, numero di notifiche, frequenza cardiaca, distanza settimanale di corsa e bici, tempo di recupero, stress, Body Battery, VO2 max corsa e bici, stato dell'allenamento, previsioni dei tempi di gara, Pulse Ox, frequenza respiratoria, ricarica solare, temperatura |
| 4.2.3 | spinte in carrozzina |
| 5.0.0 | punteggio dell'ultimo giro di golf |
| 6.0.2 | punteggio del sonno |
Altri valori arrivano da moduli più vecchi. Lo storico di Body Battery e stress e il tempo di recupero si leggono dal livello API 3.2.7, il VO2 max corsa dal 3.2.5, il meteo con massima e minima del giorno dal 3.2.0. La distanza settimanale ha un articolo tutto suo, come la distanza settimanale arriva su un quadrante, e l'HRV mancante è trattato in stato HRV e Training Readiness.
Quali orologi non hanno complicazioni
Gli orologi sotto il livello API Connect IQ 4.2.0 non ne hanno. Tra gli orologi Garmin AMOLED rotondi, il Venu originale e il Venu Mercedes-Benz Collection si fermano al 3.3.6 e il D2 Air al 3.2.1. In un test nel simulatore sul Venu originale, una build di prova di Umbra ha mostrato ogni campo tranne la distanza settimanale, rimasta a -- perché lì mancano le complicazioni. Garmin elenca i dispositivi supportati sulla stessa pagina dell'API.