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

Схема признаков Smart Home OpenClose

action.devices.traits.OpenClose — этот трейт относится к устройствам, которые поддерживают открытие и закрытие, а в некоторых случаях частичное или потенциальное открытие и закрытие более чем в одном направлении.

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

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

Атрибуты Тип Описание
discreteOnlyOpenClose логический

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

Если установлено значение true, это указывает, что устройство должно быть либо полностью открыто, либо полностью закрыто (то есть оно не поддерживает значения от 0% до 100%).

openDirection Множество

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

[ item, ... ] Нить

Поддерживаемое направление.

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

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose логический

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

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

queryOnlyOpenClose логический

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

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

Примеры

Простое открывающее-закрывающее устройство.

{
  "discreteOnlyOpenClose": true
}

Устройство «сверху-вниз-снизу-вверх». Может открываться в любую сторону.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

Устройство только для команд.

{
  "commandOnlyOpenClose": true
}

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

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

Полезная нагрузка содержит одно из следующего:

Одностороннее открытие-закрытие

состояния Тип Описание
openPercent Число

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

Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто.

Несколько направлений открыть-закрыть

состояния Тип Описание
openState Множество

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

Список состояний для каждого поддерживаемого направления открытия.

[ item, ... ] Объект

Текущее состояние для данного открытого направления.

openPercent Число

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

Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто.

openDirection Нить

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

Направление, в котором открывается устройство.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

Примеры

Простое открывающее-закрывающее устройство.

{
  "openPercent": 100
}

Откройте устройство на 30% вниз и на 50% вверх.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

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

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

action.devices.commands.OpenClose

Установите открытое-закрытое состояние устройства.

Параметры

Параметры Тип Описание
openPercent Число

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

Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто.

openDirection Нить

Направление открытия. Присутствует только в том случае, если устройство поддерживает несколько направлений, как указано в openDirection , и направление указано пользователем.

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

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken Нить

Предоставленный Google токен для последующего ответа.

Примеры

Откройте устройство.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Откройте устройство на 50 процентов вниз.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

Произошла ошибка установки состояния открытия-закрытия устройства.

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

lockedState
deviceJammingDetected

Последующие ответы

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

Полезная нагрузка содержит одно из следующего:

Успех

Поля Тип Описание
followUpToken Нить

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

Токен, указанный в исходном запросе EXECUTE.

status Нить

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

Результат запроса.

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

SUCCESS
openPercent Число

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

Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто.

Отказ

Поля Тип Описание
followUpToken Нить

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

Токен, указанный в исходном запросе EXECUTE.

status Нить

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

Результат запроса.

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

FAILURE
errorCode Нить

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

Значением может быть любой код ошибки для этого трейта, например, lockedState .

Примеры

Откройте дверь гаража. (последующий ответ в случае успеха)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Откройте дверь гаража. (последующий ответ в случае отказа)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

Отрегулируйте состояние открытия-закрытия устройства относительно текущего состояния. Эта команда доступна только в том случае, если для commandOnlyOpenClose установлено значение true .

Для этой команды требуются следующие атрибуты:
{
  "commandOnlyOpenClose": true
}

Параметры

Параметры Тип Описание
openRelativePercent Число

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

Точный процент изменения состояния открытия-закрытия. Неоднозначные относительные команды будут преобразованы в точный параметр в процентах (например, «Приоткройте жалюзи еще немного» вместо «Откройте жалюзи на 5%»).

openDirection Нить

Направление открытия. Присутствует только в том случае, если устройство поддерживает несколько направлений, как указано в openDirection , и направление указано пользователем.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

Примеры

Откройте устройство немного больше

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

Закройте устройство на 10 % больше

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Откройте устройство еще на 50% вниз.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Произошла ошибка установки состояния открытия-закрытия устройства.

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

lockedState
deviceJammingDetected

Примеры высказываний

де-DE

  • Битте оффне умереть жалюзи ауф 30%
  • Фенстерладен гм 25 % Шлиссен
  • Маха ден Роллладен цу
  • Маха умереть Роллос ауф
  • шлиссе умереть Rollläden Эйн Бисшен больше
  • Оффне умереть жалюзи гм 25%

en-US

  • Закрывать жалюзи 25% в моя комната
  • Закрывать дверь более
  • Просто закрыть входная дверь
  • открытым жалюзи в моей комнате
  • открытым жалюзи к 25%
  • открытым дверь по 25%

эс-эс

  • абре Ла-Вентана-дель-Салон
  • серрар персианас дель общежитие ООН 20%
  • сьерра ла кортина дель салон
  • сьерра много больше Ла Вентана
  • quiero que subas ла персиана все 25%
  • подчиненный 20% лас персианас

а как

  • бейс магазины де 10%
  • ферма магазины
  • ферма un peu магазины
  • произведение магазины
  • произведение Les Stores de la Chambre де 25%
  • произведение магазины а 25%

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

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