Схема свойств 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": 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

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

Для этой команды требуются следующие атрибуты:
{
  "commandOnlyOpenClose": 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

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

де-DE

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

ru-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

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • Сьерра mucho Муго- cierra 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
  • les stores ferme Les
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

привет-IN

  • कृपया 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프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

нл-нл

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

пт-БР

  • 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

св-ЮВ

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

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

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