Схема свойств таймера умного дома

action.devices.traits.Timer — признак Timer представляет таймер на устройстве.

Например, интеллектуальный контроллер разбрызгивателя или интеллектуальный выключатель освещения могут иметь встроенный таймер. Эту особенность можно использовать для управления встроенным таймером на устройствах, например, для запуска нового таймера, а также для приостановки и отмены работающего таймера, а также для запроса, сколько времени осталось.

АТРИБУТЫ устройства

Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
maxTimerLimitSec Целое число

Необходимый.

Указывает наибольшую настройку таймера, доступную на устройстве, измеряемую в секундах.

commandOnlyTimer логическое значение

(По умолчанию: false )

Указывает, поддерживает ли устройство использование односторонней (истинной) или двусторонней (ложной) связи. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или состояние отчета для этого признака.

Примеры

Устройство с двухчасовым таймером.

{
  "maxTimerLimitSec": 7200
}

СОСТОЯНИЯ устройства

Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY . Дополнительные сведения об обработке намерений QUERY см. в разделе Выполнение намерений .

Штаты Тип Описание
timerRemainingSec Целое число

Необходимый.

Оставшееся текущее время в секундах, -1 или [0, maxTimerLimitSec ]. Установите значение -1, чтобы указать, что таймер не работает.

timerPaused логическое значение

Истинно, если активный таймер существует, но в данный момент приостановлен.

Примеры

Сколько времени осталось на таймере устройства? (не бежит).

{
  "timerRemainingSec": -1
}

Сколько времени осталось на таймере устройства? (бег).

{
  "timerRemainingSec": 60
}

Сколько времени осталось на таймере устройства? (пауза).

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

КОМАНДЫ устройства

Устройства с этой особенностью могут реагировать на следующие команды в рамках операции EXECUTE . Дополнительные сведения об обработке намерений EXECUTE см. в разделе Выполнение намерения .

action.devices.commands.TimerStart

Запустите новый таймер.

Параметры

Параметры Тип Описание
timerTimeSec Целое число

Необходимый.

Длительность таймера в секундах; должно быть в пределах [1, maxTimerLimitSec ].

Примеры

Запустите таймер устройства на пять минут.

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

Произошла ошибка при запуске таймера.

Поддерживаемые значения:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Отрегулируйте продолжительность таймера.

Параметры

Параметры Тип Описание
timerTimeSec Целое число

Необходимый.

Положительная или отрицательная регулировка таймера в секундах; должно находиться в пределах [ -maxTimerLimitSec , maxTimerLimitSec ].

Примеры

Добавьте одну минуту к таймеру устройства.

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

Вычитает 30 секунд из таймера устройства.

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

Произошла ошибка при настройке таймера.

Поддерживаемые значения:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Таймер паузы.

Параметры

Параметры Тип Описание

Нет свойств

Примеры

Приостановите таймер устройства.

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

Произошла ошибка при приостановке таймера.

Поддерживаемые значения:

noTimerExists

action.devices.commands.TimerResume

Возобновить таймер.

Параметры

Параметры Тип Описание

Нет свойств

Примеры

Возобновите таймер устройства.

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

Произошла ошибка при возобновлении таймера.

Поддерживаемые значения:

noTimerExists

action.devices.commands.TimerCancel

Отмените таймер.

Параметры

Параметры Тип Описание

Нет свойств

Примеры

Остановите таймер устройства. 

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

Произошла ошибка при остановке таймера.

Поддерживаемые значения:

noTimerExists

ОШИБКИ устройства

Полный список ошибок и исключений смотрите .