Схема характеристик 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 или сообщить о состоянии для этого признака.

queryOnlyOpenClose Булевое значение

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

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

Примеры

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

{
  "discreteOnlyOpenClose": true
}

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

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

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

{
  "commandOnlyOpenClose": false
}

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

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

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

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

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

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

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

targetOpenPercent Число

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

Многонаправленное открытие-закрытие

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

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

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

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

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

openPercent Число

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

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

targetOpenPercent Число

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

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 — полностью открыто.

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

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

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

Параметры

Параметры Тип Описание
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

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

де-ДЕ

  • 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

  • open Are the blinds in the kitchen
  • 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

fr-FR

  • 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%

привет-IN

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

it-IT

  • 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 voor 25% dicht de jaloezieën
  • doe het raam ietsje meer dicht
  • open is de voordeur
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • 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

св-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%

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

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