Эта страница переведена с помощью Cloud Translation API.

Схема признаков 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": false
}

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

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

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

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

состояния Тип Описание

состояния	Тип	Описание
`openPercent`	Число	Необходимый. Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто.

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 токен для последующего ответа.

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

Нить

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

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

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

SUCCESS

openPercent

Число

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

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

Отказ

Поля Тип Описание

Поля	Тип	Описание
`followUpToken`	Нить	Необходимый. Токен, указанный в исходном запросе EXECUTE.
`status`	Нить	Необходимый. Результат запроса. Поддерживаемые значения: `FAILURE`
`errorCode`	Нить	Необходимый. Значением может быть любой код ошибки для этого трейта, например, `lockedState` .

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`

openRelativePercent

Число

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

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

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

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

эс-эс

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á abiertala puerta
quiero que subas la persiana al 25%
sube un 20% las persianas

а как

baisse les stores de 10%
est-ce quela 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% खुले पर सेट कर दीजिए
ब्लाइंड को थोड़ा और बंद कर दिजिए
ब्लाइंड बंद करें

это-это

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%
è apertala porta d'ingresso

ja-JP

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

ко-КР

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

нл-нл

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

пт-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

св-СЭ

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

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

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

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

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

Примеры

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

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

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

Примеры

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

action.devices.commands.OpenClose

Параметры

Примеры

Связанные ошибки

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

Успех

Отказ

Примеры

action.devices.commands.OpenCloseRelative

Параметры

Примеры

Связанные ошибки

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

де-DE

en-US

эс-эс

а как

привет-IN

это-это

ja-JP

ко-КР

нл-нл

пт-BR

св-СЭ

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

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`