Schema delle caratteristiche del timer per la smart home

action.devices.traits.Timer: la caratteristica Timer rappresenta un timer su un dispositivo.

Ad esempio, un controller o un interruttore smart smart può avere un timer integrato. Questa caratteristica può essere utilizzata per controllare un timer integrato sui dispositivi, ad esempio per avviare un nuovo timer, mettere in pausa e annullare un timer in esecuzione e chiedere quanto tempo manca.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi	Tipo	Descrizione
maxTimerLimitSec	Intero	Obbligatorio. Indica l'impostazione più lunga del timer disponibile sul dispositivo, misurata in secondi.
commandOnlyTimer	Booleano	(Valore predefinito: false) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

Esempi

Dispositivo con un timer di due ore.

{
  "maxTimerLimitSec": 7200
}

STATEs dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati	Tipo	Descrizione
timerRemainingSec	Intero	Obbligatorio. Tempo attuale rimanente in secondi: -1 o [0, maxTimerLimitSec]. Impostalo su -1 per indicare che non è in corso alcun timer.
timerPaused	Booleano	True se esiste un timer attivo, ma è attualmente in pausa.

Esempi

Quanto tempo rimane sul timer del dispositivo? (non in esecuzione).

{
  "timerRemainingSec": -1
}

Quanto tempo rimane sul timer del dispositivo? (in esecuzione).

{
  "timerRemainingSec": 60
}

Quanto tempo rimane sul timer del dispositivo? (in pausa).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

comandi del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Soddisfazione degli intent.

action.devices.commands.TimerStart

Avvia un nuovo timer.

Parametri

Parametri	Tipo	Descrizione
timerTimeSec	Intero	Obbligatorio. Durata del timer in secondi; deve essere entro [1, maxTimerLimitSec].

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

Errori correlati

Si è verificato un errore durante la regolazione del timer.

Valori supportati:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

Mette 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 riattivazione 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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.