Схема характеристик режимов умного дома
action.devices.traits.Modes
— эта черта охватывает все доступные режимы и настройки, специфичные для режима, для устройства.
Эта особенность принадлежит любым устройствам с произвольным количеством «n-способных» режимов, в которых режимы и настройки для каждого режима произвольны и уникальны для каждого устройства или типа устройства. Каждый режим имеет несколько возможных настроек, но одновременно можно выбрать только одну; сушильная машина не может одновременно находиться в «деликатном», «нормальном» и «тяжелом» режиме. Параметр, который можно просто включить или выключить, относится к свойству 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, если устройство не может ответить на намерение 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" } } }
Примеры высказываний
де-DE
- Stelle den Staubsauger auf Ruhemodus
ru-US
- set the vacuum to mode energy saver
эс-ES
- pon la lavadora en modo frío
пт-пятница
- mets l'aspirateur en silencieux
привет-IN
- वैक्यूम पर कार्पेट मोड लगाएं
это-ИТ
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機を静音モードに設定して
ко-КР
- 세탁기 세탁량 많음 으로 설정해
пт-БР
- aspirador acionar a função autolimpeza do
- ligar o modo de aquecimento