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

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, ... ] Объект

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

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 , см. Intent performment .

Штаты Тип Описание
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

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

это-ИТ

  • metti il condizionatore in salotto a velocità media

ja-JP

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

ко-КР

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

пт-BR

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

св-SE

  • Ställ in fläkten på medel

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

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