Схема признаков Smart Home OpenClose
action.devices.traits.OpenClose
— этот трейт относится к устройствам, которые поддерживают открытие и закрытие, а в некоторых случаях частичное или потенциальное открытие и закрытие более чем в одном направлении.
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
discreteOnlyOpenClose | логический | (По умолчанию: Если установлено значение true, это указывает, что устройство должно быть либо полностью открыто, либо полностью закрыто (то есть оно не поддерживает значения от 0% до 100%). |
openDirection | Множество | Список поддерживаемых направлений, в которых устройство может открываться или закрываться. Включите этот атрибут, если устройство поддерживает открытие и закрытие более чем в одном направлении. |
[ item, ... ] | Нить | Поддерживаемое направление. Поддерживаемые значения:
|
commandOnlyOpenClose | логический | (По умолчанию: Указывает, поддерживает ли устройство одностороннюю (правда) или двустороннюю (ложь) связь. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или отчет о состоянии для этой черты. |
queryOnlyOpenClose | логический | (По умолчанию: Указывает, можно ли запрашивать только информацию о состоянии устройства и нельзя ли им управлять. Датчики, которые могут сообщать только об открытом состоянии, должны установить в этом поле значение true. |
Примеры
Простое открывающее-закрывающее устройство.
{ "discreteOnlyOpenClose": true }
Устройство «сверху-вниз-снизу-вверх». Может открываться в любую сторону.
{ "openDirection": [ "UP", "DOWN" ] }
Устройство только для команд.
{ "commandOnlyOpenClose": false }
СОСТОЯНИЯ устройства
Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
Полезная нагрузка содержит одно из следующего:
Одностороннее открытие-закрытие
состояния | Тип | Описание |
---|---|---|
openPercent | Число | Необходимый. Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто. |
Несколько направлений открыть-закрыть
состояния | Тип | Описание |
---|---|---|
openState | Множество | Необходимый. Список состояний для каждого поддерживаемого направления открытия. |
[ item, ... ] | Объект | Текущее состояние для данного открытого направления. |
openPercent | Число | Необходимый. Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто. |
openDirection | Нить | Необходимый. Направление, в котором открывается устройство. Поддерживаемые значения:
|
Примеры
Простое открывающее-закрывающее устройство.
{ "openPercent": 100 }
Откройте устройство на 30% вниз и на 50% вверх.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
КОМАНДЫ устройства
Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE
. Дополнительные сведения об обработке намерений EXECUTE
см. в разделе Выполнение намерений .
action.devices.commands.OpenClose
Установите открытое-закрытое состояние устройства.
Параметры
Параметры | Тип | Описание |
---|---|---|
openPercent | Число | Необходимый. Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто. |
openDirection | Нить | Направление открытия. Присутствует только в том случае, если устройство поддерживает несколько направлений, как указано в атрибуте Поддерживаемые значения:
|
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 | Нить | Необходимый. Результат запроса. Поддерживаемые значения:
|
openPercent | Число | Необходимый. Указывает процент открытия устройства, где 0 — закрыто, а 100 — полностью открыто. |
Отказ
Поля | Тип | Описание |
---|---|---|
followUpToken | Нить | Необходимый. Токен, указанный в исходном запросе EXECUTE. |
status | Нить | Необходимый. Результат запроса. Поддерживаемые значения:
|
errorCode | Нить | Необходимый. Значением может быть любой код ошибки для этого трейта, например, |
Примеры
Откройте дверь гаража. (последующий ответ в случае успеха)
{ "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 | Нить | Направление открытия. Присутствует только в том случае, если устройство поддерживает несколько направлений, как указано в атрибуте Поддерживаемые значения:
|
Примеры
Откройте устройство немного больше
{ "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%