Schema delle funzionalità del timer per la smart home
action.devices.traits.Timer
: il trait Timer rappresenta un timer su un dispositivo.
Ad esempio, un controller per irrigatori o una luce smart potrebbe avere un timer integrato. Questo tratto può essere usato per controllare un timer integrato su dispositivi, ad esempio l'avvio di un nuovo timer, la messa in pausa e l'annullamento di un timer in funzione e che chiede quanto tempo manca.
ATTRIBUTES dispositivo
I dispositivi con questo tratto potrebbero segnalare quanto segue
nell'ambito dell'operazione SYNC
. Per ulteriori informazioni
scopri di più sulla gestione degli intent SYNC
; consulta
Completamento dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
maxTimerLimitSec |
Intero |
Obbligatorio. Indica l'impostazione del timer più lungo disponibile sul dispositivo, misurata in secondi. |
commandOnlyTimer |
Valore booleano |
(Valore predefinito: Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato per questo tratto. |
Esempi
Dispositivo con un limite di due ore per il timer.
{ "maxTimerLimitSec": 7200 }
STATES del dispositivo
Le entità con questo tratto possono segnalare quanto segue
nell'ambito dell'operazione QUERY
. Per ulteriori informazioni
scopri di più sulla gestione degli intent QUERY
; consulta
Completamento dell'intent.
Stati | Tipo | Descrizione |
---|---|---|
timerRemainingSec |
Intero |
Obbligatorio. Tempo attuale rimanente in secondi, -1 o [0, |
timerPaused |
Valore booleano |
True se esiste un timer attivo, ma al momento è in pausa. |
Esempi
Quanto tempo manca al timer del dispositivo? (non in esecuzione).
{ "timerRemainingSec": -1 }
Quanto tempo manca al timer del dispositivo? (in esecuzione).
{ "timerRemainingSec": 60 }
Quanto tempo manca al timer del dispositivo? (in pausa).
{ "timerRemainingSec": 30, "timerPaused": true }
COMANDI dispositivo
I dispositivi con questo tratto potrebbero rispondere ai seguenti
nell'ambito dell'operazione EXECUTE
. Per ulteriori informazioni
scopri di più sulla gestione degli intent EXECUTE
; consulta
Completamento dell'intent.
action.devices.commands.TimerStart
Avvia un nuovo timer.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
timerTimeSec |
Intero |
Obbligatorio. Durata del timer in secondi; deve essere all'interno di [1, |
Esempi
Esegui il timer del dispositivo per 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 all'interno di [ |
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
Riprendere 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 il ripristino 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