Схема признаков 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 auf30% Fensterläden um25 % schliessen- Ist
die Jalousie zu? - Mach
den Rollladen zu - Mach
die Rollos auf - schließe
die Rollläden ein bisschen mehr - Öffne
die Jalousien um25%
en-US
- Are
the blinds in the kitchen open - Close
the blinds 25% inmy room - Close
the door more - Just close
the front door - open
the blinds in my room - open
the blinds to25% - open
the door by25%
эс-эс
- abre
la ventana del salón - cerrar
persianas del dormitorio un20% - cierra
la cortina del salón - cierra
mucho másla ventana - está abierta
la puerta - quiero que subas
la persiana al25% - sube un
20% las persianas
а как
- baisse
les stores de10% - 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 de25% - ouvre
les stores à25%
привет-IN
- कृपया
25% पर्दे को खुला रखो - क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? पर्दे को25% बंद करोगेपर्दे खोलोब्लाइंड 25% खुले पर सेट कर दीजिएब्लाइंड कोथोड़ा और बंद कर दिजिएब्लाइंड बंद करें
это-это
- abbassa
un po' di piùle tapparelle - apri
la serranda - apri
la tapparella al30% - apri
le serrande del30% - chiudi
le serrande - chiudi
le tende del25% - è aperta
la porta d'ingresso
ja-JP
25% にブラインド を開けて25% ブラインド を閉めてください25% ブラインド 開けてブラインド 閉めてブラインド 開けて少し ブラインド を閉じて玄関のドア は開いてますか
ко-КР
문 살짝만 닫아 줘블라인드 25% 열어 줘블라인드 25% 까지 열어 줘블라인드 30프로 닫아블라인드 닫아 줘블라인드 열어 줘안방 문 열렸어
нл-нл
- doe
de gordijnen 25% open - doe
de jaloezieën voor25% dicht - doe
het raam ietsje meer dicht - is
de voordeur open - open
de gordijnen - sluit
het gordijn - zet
de luxaflex voor50% 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 a50% - abrir
as cortinas - abrir
as cortinas na sala em30% - fecha
a persiana por favor - fecha
um bocado a janela - fechar
as cortinas em25% - fechar
um pouco maisas cortinas
св-СЭ
- Dra
upp persiennerna - Dra upp
persiennerna till25% - stäng
persiennen i mitt rum 25% - stäng
persiennerna - är
ytterdörren öppen? - öppna
persiennerna med25%