Схема признаков умного домашнего таймера
action.devices.traits.Timer
— черта Timer представляет собой таймер на устройстве.
Например, интеллектуальный контроллер разбрызгивателя или интеллектуальный выключатель света может иметь встроенный таймер. Эта черта может использоваться для управления встроенным таймером на устройствах, например, для запуска нового таймера, а также для приостановки и отмены работающего таймера и запроса, сколько времени осталось.
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
maxTimerLimitSec | Целое число | Необходимый. Указывает самую длинную настройку таймера, доступную на устройстве, измеряемую в секундах. |
commandOnlyTimer | логический | (По умолчанию: Указывает, поддерживает ли устройство одностороннюю (правда) или двустороннюю (ложь) связь. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или отчет о состоянии для этой черты. |
Примеры
Устройство с двухчасовым лимитом таймера.
{ "maxTimerLimitSec": 7200 }
СОСТОЯНИЯ устройства
Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
состояния | Тип | Описание |
---|---|---|
timerRemainingSec | Целое число | Необходимый. Текущее оставшееся время в секундах, -1 или [0, |
timerPaused | логический | Истинно, если активный таймер существует, но в настоящее время приостановлен. |
Примеры
Сколько времени осталось на таймере устройства? (не бегать).
{ "timerRemainingSec": -1 }
Сколько времени осталось на таймере устройства? (бег).
{ "timerRemainingSec": 60 }
Сколько времени осталось на таймере устройства? (пауза).
{ "timerRemainingSec": 30, "timerPaused": true }
КОМАНДЫ устройства
Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE
. Дополнительные сведения об обработке намерений EXECUTE
см. в разделе Выполнение намерений .
action.devices.commands.TimerStart
Запустите новый таймер.
Параметры
Параметры | Тип | Описание |
---|---|---|
timerTimeSec | Целое число | Необходимый. Длительность таймера в секундах; должно быть в пределах [1, |
Примеры
Запустите таймер устройства на пять минут.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Связанные ошибки
Произошла ошибка запуска таймера.
Поддерживаемые значения:
-
noTimerExists
-
timerValueOutOfRange
-
aboveMaximumTimerDuration
-
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Отрегулируйте продолжительность таймера.
Параметры
Параметры | Тип | Описание |
---|---|---|
timerTimeSec | Целое число | Необходимый. Положительная или отрицательная настройка таймера в секундах; должно быть в пределах [ |
Примеры
Добавьте одну минуту к таймеру устройства.
{ "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