Схема характеристик режимов умного дома

action.devices.traits.Modes — этот трейт охватывает все доступные режимы и настройки, специфичные для режимов, для устройства.

Эта характеристика относится к любым устройствам с произвольным количеством режимов «n-way», в которых режимы и настройки для каждого режима произвольны и уникальны для каждого устройства или типа устройства. Каждый режим имеет несколько возможных настроек, но одновременно можно выбрать только одну; сушилка не может одновременно работать в режимах «деликатная», «нормальная» и «интенсивная». Настройка, которую можно просто включить или выключить, относится к характеристике Toggles .

Например, стиральная машина может иметь настройки объёма загрузки и температуры. Оба режима являются режимами, поскольку независимы друг от друга, но каждый из них может находиться только в одном состоянии одновременно. Пользователь может явно задать режим, например, температуру, с помощью команды « Установить температуру стиральной машины на холодную».

Некоторые режимы «упорядочены» и могут регулироваться с помощью кнопок «вверх/вниз» и «увеличить/уменьшить». Например, объём загрузки (маленькая, средняя, большая) и температура чётко упорядочены (обратите внимание, что температура — это не настоящий термостат с числовым значением, как на других устройствах), а вот тип загрузки (деликатное бельё, нормальное, шерсть и т. д.) может быть другим.

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

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

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

Атрибуты Тип Описание
availableModes Множество

Необходимый.

Список доступных режимов.

[ item, ... ] Объект

Доступный режим.

name Нить

Необходимый.

Внутреннее имя режима, которое будет использоваться в командах и состояниях. Оно может быть неудобным для пользователя и будет общим для всех языков.

name_values Множество

Необходимый.

Синонимы режима на каждом из поддерживаемых языков.

[ item, ... ] Объект

Синонимы режима на заданном языке. Для обеспечения резервного языка требуется хотя бы один элемент со значением en lang , равным en.

name_synonym Множество

Необходимый.

Синонимы режима. Первая строка в этом списке используется как каноническое название уровня на данном языке.

[ item, ... ] Нить

Имя-синоним. Для обеспечения резервного языка требуется хотя бы один элемент со lang en .

lang Нить

Необходимый.

Код языка (ISO 639-1). См. поддерживаемые языки .

settings Множество

Необходимый.

Поддерживаемые настройки для этого режима.

[ item, ... ] Объект

Поддерживаемые настройки.

Требуется не менее 2 предметов.

setting_name Нить

Необходимый.

Внутреннее имя настройки режима, которое будет использоваться в командах и состояниях. Оно может быть неудобным для пользователя и будет общим для всех языков.

setting_values Множество

Необходимый.

Синонимы настройки на каждом из поддерживаемых языков.

[ item, ... ] Объект

Синонимы места действия на данном языке.

setting_synonym Множество

Необходимый.

Синонимы сеттинга. Первая строка в этом списке используется как каноническое название уровня на данном языке.

[ item, ... ] Нить

Имя-синоним.

lang Нить

Необходимый.

Код языка (ISO 639-1). См. поддерживаемые языки .

ordered Булевое значение

(По умолчанию: false )

Если задано значение true, будет применяться дополнительная грамматика для логики увеличения/уменьшения в порядке (возрастания) массива настроек.

commandOnlyModes Булевое значение

(По умолчанию: false )

Указывает, поддерживает ли устройство одностороннюю (true) или двустороннюю (false) связь. Установите этот атрибут в значение true, если устройство не может ответить на запрос QUERY или сообщить о состоянии для этого признака.

queryOnlyModes Булевое значение

(По умолчанию: false )

Требуется, если устройство поддерживает только выполнение запросов. Этот атрибут указывает, можно ли только запрашивать информацию о состоянии устройства и нельзя ли им управлять.

Примеры

Устройство с несколькими режимами и настройками.

{
  "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 Объект

Необходимый.

Пара ключ/значение, где в качестве ключа используется name режима устройства, а в качестве значения — текущее setting_name .

<string> Нить

Текущее setting_name .

Примеры

В каком режиме находится устройство?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

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

action.devices.commands.SetModes

Настройки режима обновления.

Параметры

Параметры Тип Описание
updateModeSettings Объект

Необходимый.

Пара ключ/значение, где в качестве ключа используется name режима устройства, а в качестве значения — новое setting_name .

<string> Нить

Новое setting_name .

Примеры

Установите большую нагрузку.

{
  "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

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

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