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

action.devices.traits.Timer - Трейт Timer представляет собой таймер на устройстве.

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

АТРИБУТЫ УСТРОЙСТВА

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

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

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

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

Минимальное значение: 1 .

commandOnlyTimer Логический

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

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

Примеры

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

{
  "maxTimerLimitSec": 7200
}

СОСТОЯНИЯ УСТРОЙСТВА

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

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

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

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

timerPaused Логический

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

Примеры

Сколько времени осталось до окончания работы таймера устройства? (он не запущен).

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

КОМАНДЫ УСТРОЙСТВА

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

action.devices.commands.TimerStart

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

Параметры

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

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

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

Минимальное значение: 1 .

Примеры

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

{
  "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

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

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