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

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

Схема свойств 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`	Число	Уровень, указывающий процент открытия, куда устройство перейдет или куда движется в результате продолжающегося изменения положения.

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

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

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

привет-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
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 open на 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%

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

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

Схема свойств OpenClose для умного дома

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

Примеры

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

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

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

Примеры

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

action.devices.commands.OpenClose

Параметры

Примеры

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

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

Успех

Отказ

Примеры

action.devices.commands.OpenCloseRelative

Параметры

Примеры

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

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

де-DE

ru-US

эс-ES

пт-пятница

привет-IN

это-ИТ

ja-JP

ко-КР

нл-нл

пт-БР

св-ЮВ

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

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`