Esquema del atributo del temporizador de la casa inteligente

action.devices.traits.Timer: El atributo Timer representa un temporizador en un dispositivo.

Por ejemplo, un controlador de rociadores inteligente o un interruptor de luz inteligente puede tener un temporizador integrado. Esta función se puede usar para controlar un temporizador integrado en los dispositivos, como iniciar uno nuevo, pausar y cancelar uno en ejecución, y preguntar cuánto tiempo 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 cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
maxTimerLimitSec Número entero

Obligatorio.

Indica la configuración de temporizador más larga disponible en el dispositivo, medida en segundos.
commandOnlyTimer Booleano

(Predeterminado: false)

Indica si el dispositivo admite la 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 para esta función.

Ejemplos

Dispositivo con un límite de tiempo de dos horas

{
  "maxTimerLimitSec": 7200
}

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados Tipo Descripción
timerRemainingSec Número entero

Obligatorio.

Es el tiempo restante actual en segundos, -1 o [0, maxTimerLimitSec]. Establece -1 para indicar que no se está ejecutando ningún temporizador.
timerPaused Booleano

Es verdadero si existe 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? (corriendo).

{
  "timerRemainingSec": 60
}

¿Cuánto tiempo queda en el temporizador del dispositivo? (pausada).

{
  "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 intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.TimerStart

Inicia un temporizador nuevo.

Parámetros

Parámetros Tipo Descripción
timerTimeSec Número entero

Obligatorio.

Es la duración del temporizador en segundos. Debe estar entre [1, maxTimerLimitSec].

Ejemplos

Ejecuta el temporizador del dispositivo durante cinco minutos.

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

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.

Es el ajuste positivo o negativo del temporizador en segundos. Debe estar dentro de [-maxTimerLimitSec, maxTimerLimitSec].

Ejemplos

Agrega un minuto al temporizador del dispositivo.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Resta 30 segundos del temporizador del dispositivo.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

Se produjo un error al ajustar el temporizador.

Valores admitidos:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Pausa el cronómetro.

Parámetros

Parámetros Tipo Descripción

Sin propiedades

Ejemplos

Pausar el temporizador del dispositivo

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Se produjo un error cuando se detuvo el temporizador.

Valores admitidos:

noTimerExists

action.devices.commands.TimerResume

Reanudar el temporizador

Parámetros

Parámetros Tipo Descripción

Sin propiedades

Ejemplos

Reanuda el temporizador del dispositivo.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Se produjo un error cuando se reanudaba 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": {}
}

Se produjo un error cuando se detenía el temporizador.

Valores admitidos:

noTimerExists

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.