Esquema de trait del temporizador de casa inteligente
action.devices.traits.Timer
: La característica de temporizador representa un temporizador en un dispositivo.
Por ejemplo, un control de aspersor o un interruptor de lámpara inteligente pueden tener un temporizador incorporado. Esta característica se puede usar para controlar un temporizador integrado en los dispositivos, por ejemplo, para iniciar uno nuevo o pausar y cancelar un temporizador en curso, y preguntar cuánto tiempo queda.
Dispositivo ATTRIBUTES
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo controlar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
maxTimerLimitSec |
Número entero |
Obligatorio. Indica el parámetro de configuración del temporizador más largo disponible en el dispositivo, medido en segundos. |
commandOnlyTimer |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de QUERY o a un estado de informe de esta característica. |
Ejemplos
Dispositivo con límite de temporizador de dos horas
{ "maxTimerLimitSec": 7200 }
Dispositivo STATES
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo controlar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
timerRemainingSec |
Número entero |
Obligatorio. Tiempo restante en segundos, -1, o [0, |
timerPaused |
Booleano |
Es verdadero si hay un temporizador activo, pero está pausado. |
Ejemplos
¿Cuánto tiempo queda en el temporizador del dispositivo? (no se está ejecutando).
{ "timerRemainingSec": -1 }
¿Cuánto tiempo queda en el temporizador del dispositivo? (en ejecución).
{ "timerRemainingSec": 60 }
¿Cuánto tiempo queda en el temporizador del dispositivo? (pausado).
{ "timerRemainingSec": 30, "timerPaused": true }
COMANDOS del dispositivo
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo controlar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.TimerStart
Inicia un nuevo temporizador.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
timerTimeSec |
Número entero |
Obligatorio. Duración del temporizador en segundos; debe estar entre [1, |
Ejemplos
Ejecuta el temporizador del dispositivo durante cinco minutos.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Errores relacionados
Se produjo un error al iniciar el temporizador.
Valores admitidos:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Ajusta la duración del temporizador.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
timerTimeSec |
Número entero |
Obligatorio. Ajuste positivo o negativo del temporizador en segundos; debe estar entre [ |
Ejemplos
Agrega un minuto al temporizador del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Resta 30 segundos al temporizador del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Errores relacionados
Se produjo un error cuando se ajustaba el temporizador.
Valores admitidos:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Pausa el temporizador.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Pausa el temporizador del dispositivo.
{ "command": "action.devices.commands.TimerPause", "params": {} }
Errores relacionados
Se produjo un error al pausar el temporizador.
Valores admitidos:
noTimerExists
action.devices.commands.TimerResume
Reanuda el temporizador.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Reanuda el temporizador del dispositivo.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Errores relacionados
Se produjo un error al reanudar el temporizador.
Valores admitidos:
noTimerExists
action.devices.commands.TimerCancel
Cancela el temporizador.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Detén el temporizador del dispositivo.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
Errores relacionados
Se produjo un error al detener el temporizador.
Valores admitidos:
noTimerExists