Схема характеристик FanSpeed ​​для умного дома

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

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

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

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

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

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

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

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

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

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

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

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

availableFanSpeeds Объект

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

Настройки скорости, поддерживаемые устройством.

speeds Множество

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

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

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

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

speed_name Нить

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

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

speed_values Множество

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

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

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

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

speed_synonym Множество

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

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

[ item, ... ] Нить

Синоним.

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

Примеры

Какая скорость вентиляторов в гостиной?

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

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

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

action.devices.commands.SetFanSpeed

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

Параметры

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

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

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

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

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

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

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

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

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

Примеры

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

{
  "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 Целое число

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

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

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

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

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

Это значение представляет процент скорости, которую необходимо изменить.

Примеры

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

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

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

де-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

ru-US

  • drop скорость the AC fan speed to medium

эс-ES

  • medio cambia la velocidad del ventilador a

а как

  • mets la ventilation au maximum

привет-IN

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

это-ИТ

  • metti il condizionatore in salotto a velocità media

ja-JP

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

ко-КР

  • 선풍기 강풍 으로 틀어 줘

нл-нл

  • Зет op Снелхейд zet de snelheid van de ventilator medium

пт-БР

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

св-ЮВ

  • Ställ in fläkten medel

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

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