Schema caratteristiche del timer per la smart home
action.devices.traits.Timer
: il trait Timer rappresenta un timer su un dispositivo.
Ad esempio, un controller di irrigatori o un interruttore della luce smart potrebbero avere un timer integrato. Questa caratteristica può essere utilizzata per controllare un timer integrato sui dispositivi, ad esempio per avviare un nuovo timer, nonché per mettere in pausa e annullare un timer in esecuzione e per chiedere quanto tempo rimane.
ATTRIBUTES del dispositivo
I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta fulfillment dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
maxTimerLimitSec |
Intero |
Obbligatorio. Indica l'impostazione del timer più lunga disponibile sul dispositivo, misurata in secondi. |
commandOnlyTimer |
Booleano |
(Valore predefinito: Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait. |
Esempi
Dispositivo con limite di timer di due ore.
{ "maxTimerLimitSec": 7200 }
Dispositivo STATES
Le entità con questo trait possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta fulfillment dell'intent.
Stati | Tipo | Descrizione |
---|---|---|
timerRemainingSec |
Intero |
Obbligatorio. Tempo attuale rimanente in secondi, -1 o [0, |
timerPaused |
Booleano |
True se esiste un timer attivo ma è attualmente in pausa. |
Esempi
Quanto tempo manca allo scadere del timer del dispositivo? (non in esecuzione).
{ "timerRemainingSec": -1 }
Quanto tempo manca allo scadere del timer del dispositivo? (in esecuzione).
{ "timerRemainingSec": 60 }
Quanto tempo manca allo scadere del timer del dispositivo? (in pausa).
{ "timerRemainingSec": 30, "timerPaused": true }
COMMANDS dispositivo
I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta fulfillment dell'intent.
action.devices.commands.TimerStart
Avvia un nuovo timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
timerTimeSec |
Intero |
Obbligatorio. Durata del timer in secondi; non deve superare [1, |
Esempi
Attiva un timer del dispositivo di cinque minuti.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Errori correlati
Si è verificato un errore durante l'avvio del timer.
Valori supportati:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Regola la durata del timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
timerTimeSec |
Intero |
Obbligatorio. Regolazione positiva o negativa del timer in secondi; deve essere compresa nell'intervallo [ |
Esempi
Aggiungi un minuto al timer del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Sottrae 30 secondi dal timer del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Errori correlati
Si è verificato un errore durante la regolazione del timer.
Valori supportati:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Metti in pausa il timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Metti in pausa il timer del dispositivo.
{ "command": "action.devices.commands.TimerPause", "params": {} }
Errori correlati
Si è verificato un errore durante la messa in pausa del timer.
Valori supportati:
noTimerExists
action.devices.commands.TimerResume
Riprendi il timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Riprendi il timer del dispositivo.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Errori correlati
Si è verificato un errore durante la ripresa del timer.
Valori supportati:
noTimerExists
action.devices.commands.TimerCancel
Annulla il timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Interrompi il timer del dispositivo.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
Errori correlati
Si è verificato un errore durante l'interruzione del timer.
Valori supportati:
noTimerExists