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

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 логическое значение

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

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

commandOnlyModes логическое значение

(По умолчанию: 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"
    }
  }
}

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

де-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

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

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