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

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

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

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

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

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

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

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

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

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

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

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

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

availableFanSpeeds Объект

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

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

speeds Множество

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

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

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

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

speed_name Нить

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

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

speed_values Множество

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

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

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

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

speed_synonym Множество

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

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

[ item, ... ] Нить

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

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

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

де-ДЕ

  • 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

fr-FR

  • mets la ventilation au maximum

привет-IN

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

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

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

ко-КР

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

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

св-SE

  • Ställ in fläkten på medel

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

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