Руководство по жалюзи для умного дома
action.devices.types.BLINDS
— жалюзи можно открывать и закрывать, поддерживаются различные типы жалюзи, такие как венецианские (открываются в одном направлении), панельные или вертикальные (могут открываться влево или вправо), а также жалюзи сверху вниз. вверх (может открываться вверх или вниз). Некоторые жалюзи могут иметь планки, которые можно поворачивать.
Этот тип указывает, что устройство получает значок «Жалюзи» и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Подробности реализации, такие как атрибуты и состояния, которые должна поддерживать ваша служба, а также способы построения ответов EXECUTE и QUERY см. в соответствующей документации по трейтам.
Требуемые черты
Эти свойства и команды являются обязательными, если они применимы к вашему устройству.
Рекомендуемые черты
Эти характеристики рекомендуются, если применимы к вашему устройству. Тем не менее, вы можете смешивать и сочетать все доступные черты, чтобы наилучшим образом соответствовать функциональным возможностям вашего существующего продукта.
Требования к качеству
- Задержка: должна быть меньше или равна 2500 мс .
- Надежность: должна быть больше или равна 97% .
Пример устройства: Простые жалюзи
Этот раздел содержит примеры полезной нагрузки Intent, представляющей общие «жалюзи» в зависимости от типа устройства и характеристик, указанных выше. Если вы добавляете или удаляете черты в своей реализации, измените свои ответы соответствующим образом, чтобы отразить эти изменения.
В оконных жалюзи сверху вниз снизу вверх направление UP
поднимает нижнюю часть жалюзи, а направление DOWN
опускает верхнюю часть жалюзи. На рис. 1 показан пример жалюзи «сверху-вниз-снизу-вверх», где направление UP
поднимает нижнюю часть жалюзи на 50 процентов, а направление DOWN
опускает верхнюю часть жалюзи на 30 процентов.

Пример ответа SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BLINDS", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple blinds" }, "willReportState": true, "attributes": { "openDirection": [ "UP", "DOWN" ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Пример ответа на ЗАПРОС
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } } }
Примеры команд EXECUTE
Открыто закрыто
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.OpenClose
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 10, "openDirection": "DOWN" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } ] } }