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

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

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

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

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

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

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

openDirection Множество

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

[ item, ... ] Нить

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

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

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

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

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

queryOnlyOpenClose Логический

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

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

Примеры

Простое устройство для открытия и закрытия.

{
  "discreteOnlyOpenClose": true
}

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

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

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

{
  "commandOnlyOpenClose": false
}

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

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

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

Открытие/закрытие в одном направлении

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

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

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

Значение должно быть в диапазоне от 0 до 100 .

targetOpenPercent Число

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

Значение должно быть в диапазоне от 0 до 100 .

Открытие и закрытие в нескольких направлениях

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

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

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

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

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

openPercent Число

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

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

Значение должно быть в диапазоне от 0 до 100 .

targetOpenPercent Число

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

Значение должно быть в диапазоне от 0 до 100 .

openDirection Нить

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

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

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

UP
DOWN
LEFT
RIGHT
IN
OUT

Примеры

Простое устройство для открытия и закрытия.

{
  "openPercent": 100
}

Простое устройство открытия/закрытия, в данный момент открывающееся в новое положение.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

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

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

Откройте устройство на 30% вниз и на 50% вверх, в данный момент перемещаясь на 80% вверх.

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

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

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

action.devices.commands.OpenClose

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

Параметры

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

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

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

Значение должно быть в диапазоне от 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 — полностью открытое.

Значение должно быть в диапазоне от 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

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

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

Параметры

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

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

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

Значение должно находиться в диапазоне от -100 до 100 .

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

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

де-ДЕ

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas al 25% были la persiana
  • sube un 20% las persianas

фр-ФР

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

хай-ИН

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने чтобы он был सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को और बंद कर दिजिए थोड़ा
  • ब्लाइंड बंद करें

ИТ-ИТ

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25%にブラインドを開けて
  • 25% ブラインドを閉めてください
  • 25% ブラインド開けて
  • ブラインド閉めて
  • ブラインド開けて
  • 少しブラインドを閉じて
  • 玄関のドアは開いてますか

ко-КР

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

пт-БР

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

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

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