Схема характеристик режимов умного дома
action.devices.traits.Modes
— этот трейт охватывает все доступные режимы и настройки, специфичные для режимов, для устройства.
Эта характеристика относится к любым устройствам с произвольным количеством режимов «n-way», в которых режимы и настройки для каждого режима произвольны и уникальны для каждого устройства или типа устройства. Каждый режим имеет несколько возможных настроек, но одновременно можно выбрать только одну; сушилка не может одновременно работать в режимах «деликатная», «нормальная» и «интенсивная». Настройка, которую можно просто включить или выключить, относится к характеристике Toggles .
Например, стиральная машина может иметь настройки объёма загрузки и температуры. Оба режима являются режимами, поскольку независимы друг от друга, но каждый из них может находиться только в одном состоянии одновременно. Пользователь может явно задать режим, например, температуру, с помощью команды « Установить температуру стиральной машины на холодную».
Некоторые режимы «упорядочены» и могут регулироваться с помощью кнопок «вверх/вниз» и «увеличить/уменьшить». Например, объём загрузки (маленькая, средняя, большая) и температура чётко упорядочены (обратите внимание, что температура — это не настоящий термостат с числовым значением, как на других устройствах), а вот тип загрузки (деликатное бельё, нормальное, шерсть и т. д.) может быть другим.
Этот трейт охватывает один или несколько отдельных режимов, которые могут быть установлены пользователями. Как правило, эти режимы следует использовать для функций, не связанных с другим поведением устройства. Связанные поведения, такие как включение или выключение самого устройства, должны использовать более конкретные трейты (например, thermostatMode
в трейте TemperatureSetting ).
АТРИБУТЫ УСТРОЙСТВА
Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC
. Подробнее об обработке намерений SYNC
см. в разделе «Выполнение намерений» .
Атрибуты | Тип | Описание |
---|---|---|
availableModes | Множество | Необходимый. Список доступных режимов. |
[ item, ... ] | Объект | Доступный режим. |
name | Нить | Необходимый. Внутреннее имя режима, которое будет использоваться в командах и состояниях. Оно может быть неудобным для пользователя и будет общим для всех языков. |
name_values | Множество | Необходимый. Синонимы режима на каждом из поддерживаемых языков. |
[ item, ... ] | Объект | Синонимы режима на заданном языке. Для обеспечения резервного языка требуется хотя бы один элемент со значением |
name_synonym | Множество | Необходимый. Синонимы режима. Первая строка в этом списке используется как каноническое название уровня на данном языке. |
[ item, ... ] | Нить | Имя-синоним. Для обеспечения резервного языка требуется хотя бы один элемент со |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
settings | Множество | Необходимый. Поддерживаемые настройки для этого режима. |
[ item, ... ] | Объект | Поддерживаемые настройки. Требуется не менее 2 предметов. |
setting_name | Нить | Необходимый. Внутреннее имя настройки режима, которое будет использоваться в командах и состояниях. Оно может быть неудобным для пользователя и будет общим для всех языков. |
setting_values | Множество | Необходимый. Синонимы настройки на каждом из поддерживаемых языков. |
[ item, ... ] | Объект | Синонимы места действия на данном языке. |
setting_synonym | Множество | Необходимый. Синонимы сеттинга. Первая строка в этом списке используется как каноническое название уровня на данном языке. |
[ item, ... ] | Нить | Имя-синоним. |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
ordered | Булевое значение | (По умолчанию: Если задано значение true, будет применяться дополнительная грамматика для логики увеличения/уменьшения в порядке (возрастания) массива настроек. |
commandOnlyModes | Булевое значение | (По умолчанию: Указывает, поддерживает ли устройство одностороннюю (true) или двустороннюю (false) связь. Установите этот атрибут в значение true, если устройство не может ответить на запрос QUERY или сообщить о состоянии для этого признака. |
queryOnlyModes | Булевое значение | (По умолчанию: Требуется, если устройство поддерживает только выполнение запросов. Этот атрибут указывает, можно ли только запрашивать информацию о состоянии устройства и нельзя ли им управлять. |
Примеры
Устройство с несколькими режимами и настройками.
{ "availableModes": [ { "name": "load_mode", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_load", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "medium_load", "setting_values": [ { "setting_synonym": [ "Medium", "Normal" ], "lang": "en" } ] }, { "setting_name": "large_load", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true }, { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot", "White" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm", "Color" ], "lang": "en" } ] }, { "setting_name": "cold_temp", "setting_values": [ { "setting_synonym": [ "Cold", "Delicate" ], "lang": "en" } ] } ], "ordered": false } ] }
Устройство с режимами только команд.
{ "availableModes": [ { "name": "light_mode", "name_values": [ { "name_synonym": [ "Light", "Lighting" ], "lang": "en" } ], "settings": [ { "setting_name": "day_light", "setting_values": [ { "setting_synonym": [ "Day", "Bright" ], "lang": "en" } ] }, { "setting_name": "night_light", "setting_values": [ { "setting_synonym": [ "Night", "Dark" ], "lang": "en" } ] }, { "setting_name": "reading_light", "setting_values": [ { "setting_synonym": [ "Reading", "Ambiant" ], "lang": "en" } ] } ], "ordered": false } ], "commandOnlyModes": true, "queryOnlyModes": false }
СОСТОЯНИЯ УСТРОЙСТВА
Сущности с этой характеристикой могут сообщать о следующих состояниях в рамках операции QUERY
. Подробнее об обработке намерений QUERY
см. в разделе Выполнение намерений .
Штаты | Тип | Описание |
---|---|---|
currentModeSettings | Объект | Необходимый. Пара ключ/значение, где в качестве ключа используется |
<string> | Нить | Текущее |
Примеры
В каком режиме находится устройство?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
КОМАНДЫ устройства
Устройства с этой функцией могут реагировать на следующие команды в рамках операции EXECUTE
. Подробнее об обработке намерений EXECUTE
см. в разделе «Выполнение намерений» .
action.devices.commands.SetModes
Настройки режима обновления.
Параметры
Параметры | Тип | Описание |
---|---|---|
updateModeSettings | Объект | Необходимый. Пара ключ/значение, где в качестве ключа используется |
<string> | Нить | Новое |
Примеры
Установите большую нагрузку.
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Примеры высказываний
де-ДЕ
- Stelle den Staubsauger auf Ruhemodus
en-US
- set the vacuum to mode energy saver
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
привет-IN
- वैक्यूम कार्पेट मोड लगाएं पर
it-IT
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機を静音モードに設定して
ко-КР
- 세탁기 세탁량 많음 으로 설정해
pt-BR
- aspirador acionar a função autolimpeza do
- ligar o modo de aquecimento