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: false)

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, maxTimerLimitSec]. Imposta il valore su -1 per indicare che non è in esecuzione alcun timer.

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, maxTimerLimitSec].

Esempi

Esegui il timer del dispositivo per cinque minuti.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

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 [-maxTimerLimitSec, maxTimerLimitSec].

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
  }
}

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": {}
}

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": {}
}

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": {}
}

Si è verificato un errore durante l'interruzione del timer.

Valori supportati:

noTimerExists

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.