Esquema de la función Temporizador de casa inteligente

action.devices.traits.Timer: La característica de temporizador representa un temporizador en un dispositivo.

Por ejemplo, un controlador de aspersores inteligentes o un interruptor de luces inteligentes pueden tener un temporizador integrado. Esta característica se puede usar para controlar un temporizador integrado en dispositivos, como iniciar un temporizador nuevo, pausar y cancelar un temporizador 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 manejar los 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: false) 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 del informe para esta característica.

Ejemplos

Dispositivo con límite de temporizador de dos horas.

{
  "maxTimerLimitSec": 7200
}

Dispositivo STATEs

Los dispositivos 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 manejar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
timerRemainingSec	Número entero	Obligatorio. Tiempo restante actual en segundos, -1 o [0, maxTimerLimitSec]. Configúralo en -1 para indicar que no se está ejecutando ningún temporizador.
timerPaused	Booleano	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? (detenida).

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

Dispositivo COMMAND

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 manejar los 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 estar dentro de [1, maxTimerLimitSec].

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 [-maxTimerLimitSec, maxTimerLimitSec].

Ejemplos

Agrega un minuto al temporizador del dispositivo.

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

Reste 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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.