Умный дом переключает схему признаков

action.devices.traits.Toggles — эта черта принадлежит любым устройствам, настройки которых могут существовать только в одном из двух состояний.

Эти настройки могут представлять собой физическую кнопку с включенным/выключенным или активным/неактивным состоянием, флажок в HTML или любой другой тип специально включенного/отключенного элемента. Если параметр имеет более двух состояний или имеет состояние, в котором не выбран ни один из двоичных параметров, его лучше представить как признак Modes , который соответствует циферблатам с несколькими состояниями, переключателям (физическим или HTML) или двоичным состояния, которые не являются явно включенными/выключенными (например, «AM/FM» или «горячий/холодный»).

Эта особенность охватывает один или несколько отдельных переключателей, которые могут установить пользователи. Как правило, эти переключатели следует использовать для функций, не связанных с поведением других устройств. Связанное поведение, такое как включение или выключение самого устройства, должно использовать более конкретные свойства (например, thermostatMode в свойстве TemperatureSetting ).

АТРИБУТЫ устройства

Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты	Тип	Описание
availableToggles	Множество	Необходимый. Список доступных переключателей.
[ item, ... ]	Объект	Доступен переключатель.
name	Нить	Необходимый. Внутреннее имя переключателя, которое будет использоваться в командах и состояниях. Это может быть неудобно для пользователя и будет использоваться на всех языках.
name_values	Множество	Необходимый. Синонимы переключателя на каждом поддерживаемом языке.
[ item, ... ]	Объект	Синонимы переключателя на данном языке.
name_synonym	Множество	Необходимый. Синонимы переключателя. Первая строка в этом списке используется как каноническое имя уровня на этом языке.
[ item, ... ]	Нить	Название-синоним.
lang	Нить	Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки .
commandOnlyToggles	логическое значение	(По умолчанию: false ) Указывает, поддерживает ли устройство использование односторонней (истинной) или двусторонней (ложной) связи. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или состояние отчета для этого признака.
queryOnlyToggles	логическое значение	(По умолчанию: false ) Требуется, если устройство поддерживает выполнение только запросов. Этот атрибут указывает, можно ли запрашивать у устройства только информацию о состоянии и им нельзя управлять.

Примеры

Устройство с несколькими переключателями.

{
  "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	Объект	Необходимый. Пара ключ/значение с name переключателя устройства в качестве ключа и текущим состоянием в качестве значения.
<string>	логическое значение	Текущее состояние переключения.

Примеры

Стерилизация проводится?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

КОМАНДЫ устройства

Устройства с этой особенностью могут реагировать на следующие команды в рамках операции EXECUTE . Дополнительные сведения об обработке намерений EXECUTE см. в разделе Выполнение намерения .

action.devices.commands.SetToggles

Установите заданное состояние переключения.

Параметры

Параметры	Тип	Описание
updateToggleSettings	Объект	Необходимый. Пара ключ/значение с name переключателя устройства в качестве ключа и новым состоянием в качестве значения.
<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 auf Power Cool

ru-US

• activate power freeze for the freezer
• cancel power cool for the kitchen fridge

эс-ES

• enfriamiento rápido pon el en la nevera
• enfriamiento rápido quita el

а как

• mets le mode power cool sur le réfrigérateur
• Éteins le mode power freeze du réfrigérateur .

привет-IN

• रेफ़्रिजरेटर का मोड बंद कर दो पावर कूल
• रेफ़्रिजरेटर में पावर कूल Мэн मोड चालू करो

это-ИТ

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫の急速冷凍つけて
• 冷蔵庫の急速冷凍を切ってくれる

ко-КР

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

нл-нл

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

пт-БР

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

св-ЮВ

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

ОШИБКИ устройства

Полный список ошибок и исключений смотрите .