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

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

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

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

АТРИБУТЫ УСТРОЙСТВА

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

Примеры

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

{
  "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": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

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

Параметры

Примеры

Включите энергосбережение.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Отключить фильтр.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Примеры высказываний

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