Схема признаков умного домашнего таймера

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

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

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