Умный дом переключает схему признаков
action.devices.traits.Toggles
— эта черта относится к любым устройствам с настройками, которые могут существовать только в одном из двух состояний.
Эти настройки могут представлять собой физическую кнопку с включенным/выключенным или активным/неактивным состоянием, флажок в HTML или любой другой тип специально включенного/отключенного элемента. Если параметр имеет более двух состояний или имеет состояние, в котором не выбран ни один из бинарных параметров, его лучше представить как характеристику Modes , которая соответствует циферблатам с несколькими состояниями, переключателям (физическим или HTML) или бинарным состояния, которые явно не включены/выключены (например, "AM/FM" или "горячо/холодно").
Эта черта охватывает один или несколько отдельных переключателей, которые могут устанавливать пользователи. Как правило, эти переключатели следует использовать для функций, не связанных с другим поведением устройства. Связанное поведение, такое как включение или выключение самого устройства, должно использовать более конкретные трейты (например, thermostatMode
в трейте TemperatureSetting ).
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
availableToggles | Множество | Необходимый. Список доступных переключателей. |
[ item, ... ] | Объект | Доступный переключатель. |
name | Нить | Необходимый. Внутреннее имя переключателя, которое будет использоваться в командах и состояниях. Это может быть неудобным для пользователя и будет общим для всех языков. |
name_values | Множество | Необходимый. Синонимы переключателя на всех поддерживаемых языках. |
[ item, ... ] | Объект | Синонимы слова toggle на заданном языке. |
name_synonym | Множество | Необходимый. Синонимы слова переключатель. Первая строка в этом списке используется как каноническое имя уровня на этом языке. |
[ item, ... ] | Нить | Синоним имени. |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
commandOnlyToggles | логический | (По умолчанию: Указывает, поддерживает ли устройство одностороннюю (правда) или двустороннюю (ложь) связь. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или отчет о состоянии для этой характеристики. |
queryOnlyToggles | логический | (По умолчанию: Требуется, если устройство поддерживает выполнение только запросов. Этот атрибут указывает, можно ли запрашивать только информацию о состоянии устройства и нельзя ли им управлять. |
Примеры
Устройство с несколькими переключателями.
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
Устройство с переключателями только для команд.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Устройство с переключателями только для запроса.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
СОСТОЯНИЯ устройства
Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
состояния | Тип | Описание |
---|---|---|
currentToggleSettings | Объект | Необходимый. Пара ключ/значение с переключаемым |
<string> | логический | Текущее состояние переключения. |
Примеры
Стерилизация включена?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
КОМАНДЫ устройства
Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE
. Дополнительные сведения об обработке намерений EXECUTE
см. в разделе Выполнение намерений .
action.devices.commands.SetToggles
Установите заданное состояние переключения.
Параметры
Параметры | Тип | Описание |
---|---|---|
updateToggleSettings | Объект | Необходимый. Пара "ключ-значение" с переключаемым |
<string> | логический | Новое состояние переключения |
Примеры
Включите энергосбережение.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Отключить фильтр.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Примеры высказываний
де-DE
- Bitte schalte
Power Cool am Kühlschrank aus - stelle
den Kühlschrank aufPower Cool
en-US
- activate
power freeze forthe freezer - cancel
power cool forthe kitchen fridge
эс-эс
- pon el
enfriamiento rápido enla nevera - quita el
enfriamiento rápido
а как
- mets le mode
power cool surle réfrigérateur - Éteins le mode
power freeze duréfrigérateur .
привет-IN
रेफ़्रिजरेटर कापावर कूल मोड बंद कर दोरेफ़्रिजरेटर मेंपावर कूल मोड चालू करो
это-это
- disattiva il
power freeze del freezer - imposta la funzione
power freeze del surgelatore
ja-JP
冷蔵庫 の急速冷凍 つけて冷蔵庫 の急速冷凍 を切ってくれる
ко-КР
냉장고 급속 냉장 해제해냉장고 모드급속 냉장 으로 바꿔
нл-нл
- Zet
de power cool uit opde koelkast - zet
de koelkast opsuperkoelen
пт-BR
- Ativa a função
power freeze nocongelador . - Desativa o
bloqueio infantil doforno . - desligar o
power cool dageladeira - iniciar o modo
power freeze dofreezer
св-СЭ
- Stäng av
power cool ikylskåpet - sätt på
power freeze påfrysen