Esquema de la función Temporizador de la casa inteligente
action.devices.traits.Timer
: La característica Temporizador representa un temporizador en un dispositivo.
Por ejemplo, un controlador de aspersión inteligente o un interruptor de luz inteligente pueden tener un temporizador integrado. Esta característica se puede usar para controlar un temporizador integrado en dispositivos, como iniciar un temporizador nuevo, detener y cancelar un temporizador en ejecución y preguntar cuánto tiempo restante queda.
ATRIBUTOS DEL DISPOSITIVO
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 el manejo de intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
maxTimerLimitSec |
Número entero |
Obligatorio. Indica la configuración del temporizador más larga disponible en el dispositivo, medida 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 QUERY o al estado de informe para 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 el manejo de intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
timerRemainingSec |
Número entero |
Obligatorio. Tiempo restante restante en segundos, -1 ó [0, |
timerPaused |
Booleano |
Verdadero si existe un temporizador activo, pero actualmente 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 }
Dispositivo COMMANDS
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 el manejo de intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.TimerStart
Iniciar un temporizador nuevo
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
timerTimeSec |
Número entero |
Obligatorio. Duración del temporizador en segundos; debe ser 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 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 dentro de [ |
Ejemplos
Agrega un minuto al temporizador del dispositivo.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Restar 30 segundos del temporizador del dispositivo
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Errores relacionados
Se produjo un error al ajustar el temporizador.
Valores admitidos:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Pausar 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 detener el temporizador.
Valores admitidos:
noTimerExists
action.devices.commands.TimerResume
Reanudar 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