Esquema de trait de temporizador de casa inteligente
action.devices.traits.Timer
: La característica del temporizador representa un temporizador en un dispositivo.
Por ejemplo, un control de aspersores inteligente o una lámpara inteligente puede tener un temporizador incorporado. Esta característica se puede usar para controlar un temporizador incorporado en dispositivos, como iniciar un nuevo temporizador y pausar y cancelar un temporizador en curso, preguntando cuánto tiempo queda.
ATRIBUTOS DISPOSITIVOS
Los dispositivos con este trait pueden informar lo siguiente
atributos como parte de la operación SYNC
. Para aprender
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 CONSULTA o a un informe de estado 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 lo siguiente
estados como parte de la operación QUERY
. Para aprender
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 actual en segundos, -1 o [0, |
timerPaused |
Booleano |
Es verdadero si existe un temporizador activo, pero está pausado. |
Ejemplos
¿Cuánto tiempo queda en el temporizador del dispositivo? (no está en ejecución).
{ "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? (detenido).
{ "timerRemainingSec": 30, "timerPaused": true }
COMANDOS del dispositivo
Los dispositivos con este rasgo pueden responder a lo siguiente
comandos como parte de la operación EXECUTE
. Para aprender
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 dentro de [1, |
Ejemplos
Ejecuta el temporizador del dispositivo durante cinco minutos.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Errores relacionados
Se produjo un error cuando se iniciaba 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 en un radio de [ |
Ejemplos
Agrega 1 minuto al temporizador del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Le 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
Pausar 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