glyphlabs

Dati

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.