Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

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

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

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

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