Схема параметров скорости вращения вентилятора в умном доме

action.devices.traits.FanSpeed ​​— Этот трейт относится к устройствам, поддерживающим настройку скорости вентилятора.

Скорость вращения вентилятора (то есть, направление потока воздуха из устройства на различных уровнях, что может быть характерно для кондиционера, отопительной системы или автомобиля) может включать такие настройки, как низкая, средняя и высокая, или в процентах.

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

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

Атрибуты Тип Описание
reversible Логический

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

Если установлено значение true, это устройство поддерживает вращение вентилятора в обоих направлениях и может принимать команду на изменение направления вращения вентилятора.

commandOnlyFanSpeed Логический

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

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

Содержит любой из следующих предметов:
0 Объект

Поддержка настроек скорости.

availableFanSpeeds Объект

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

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

speeds Множество

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

Список настроек скорости.

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

Настройка скорости.

speed_name Нить

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

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

speed_values Множество

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

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

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

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

speed_synonym Множество

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

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

[ item, ... ] Нить

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

lang Нить

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

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

ordered Логический

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

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

1 Объект

Поддержка указания процента скорости.

supportsFanSpeedPercent Логический

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

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

Если установлено значение true, это устройство будет принимать команды для регулировки скорости в процентах от 0,0 до 100,0.

Примеры

Устройство с двумя скоростными режимами, поддержкой реверсивного вращения и регулировкой в ​​процентах.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

СОСТОЯНИЯ УСТРОЙСТВА

Сущности с этим свойством могут сообщать о следующих состояниях в рамках операции QUERY . Для получения дополнительной информации об обработке намерений QUERY см. раздел «Выполнение намерений» .

Штаты Тип Описание
currentFanSpeedSetting Нить

Это внутреннее имя текущей настройки скорости из атрибута availableFanSpeeds .

currentFanSpeedPercent Число

Отображает текущую скорость вращения вентилятора в процентах. Необходимо указать, если атрибут supportsFanSpeedPercent имеет значение true

Значение должно быть в диапазоне от 0 до 100 .

Примеры

С какой скоростью работают вентиляторы в гостиной?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

КОМАНДЫ УСТРОЙСТВА

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

action.devices.commands.SetFanSpeed

Установите скорость.

Параметры

Полезная нагрузка содержит один из следующих компонентов:

Скорость можно установить в настройках.

Параметры Тип Описание
fanSpeed Нить

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

Запрошенные настройки скорости вращения вентилятора.

Установите скорость в процентах.

Параметры Тип Описание
fanSpeedPercent Число

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

Запрошенный процент установки скорости.

Значение должно быть в диапазоне от 0 до 100 .

Примеры

Включите вентилятор на высокую скорость.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Установите вентилятор на 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

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

Для выполнения этой команды требуются следующие атрибуты: 
{
  "commandOnlyFanSpeed": true
}

Параметры

Полезная нагрузка содержит один из следующих компонентов:

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

Параметры Тип Описание
fanSpeedRelativeWeight Целое число

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

Это значение указывает на относительную величину изменения скорости. Абсолютное значение указывает на масштабированное значение, а числовой знак указывает направление изменения.

Значение должно быть в диапазоне от -5 до 5 .

Установите относительную скорость в процентах.

Параметры Тип Описание
fanSpeedRelativePercent Число

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

Это значение показывает процент изменения скорости.

Значение должно находиться в диапазоне от -100 до 100 .

Примеры

Немного снизьте скорость вентилятора.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Увеличьте скорость вращения вентилятора на 10 процентов.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Изменить направление вращения вентилятора.

Для выполнения этой команды требуются следующие атрибуты: 
{
  "reversible": true
}

Параметры

Параметры Тип Описание

Нет объектов недвижимости

Примеры

Измените направление вращения вентилятора.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

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

де-ДЕ

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop скорость вращения вентилятора the AC fan speed to medium

es-ES

  • Камбия medio cambia la velocidad del ventilador a

фр-ФР

  • mets la ventilation au maximum

хай-ИН

  • बेडरूम में पंखे की गति करें मीडियम

ИТ-ИТ

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコンの風量を高速にセット

ко-КР

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

пт-БР

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

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

См. полный список ошибок и исключений .
  • maxSpeedReached : Устройство уже настроено на максимальную скорость.
  • minSpeedReached : Устройство уже настроено на минимальную скорость.