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

Схема признаков 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 — полностью открыто.

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

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

Примеры

Откройте устройство.

{
  "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
  • die Jalousie Ist zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • die Jalousien Öffne 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%

эс-эс

  • 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 la persiana al 25%
  • 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 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
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

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

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

Схема признаков 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 — полностью открыто.

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

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

Примеры

Откройте устройство.

{
  "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
  • die Jalousie Ist zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • die Jalousien Öffne 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%

эс-эс

  • 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 la persiana al 25%
  • 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 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
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

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

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