Схема характеристик FanSpeed для умного дома
action.devices.traits.FanSpeed
— эта черта относится к устройствам, поддерживающим настройку скорости вентилятора.
АТРИБУТЫ устройства
Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
reversible | логическое значение | (По умолчанию: Если установлено значение true, это устройство поддерживает обдув вентилятора в обоих направлениях и может принимать команду на изменение направления вращения вентилятора. |
commandOnlyFanSpeed | логическое значение | (По умолчанию: Указывает, поддерживает ли устройство использование односторонней (истинной) или двусторонней (ложной) связи. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или состояние отчета для этого признака. |
Содержит любой из следующих элементов: | ||
0 | Объект | Поддержка настроек скорости. |
availableFanSpeeds | Объект | Необходимый. Настройки скорости, поддерживаемые устройством. |
speeds | Множество | Необходимый. Список настроек скорости. |
[ item, ... ] | Объект | Настройка скорости. |
speed_name | Нить | Необходимый. Внутреннее имя настройки скорости. Это может быть неудобно для пользователя и будет использоваться на всех языках. |
speed_values | Множество | Необходимый. Синонимы настроек скорости на каждом поддерживаемом языке. |
[ item, ... ] | Объект | Синоним настройки скорости на данном языке. |
speed_synonym | Множество | Необходимый. Синонимы настройки скорости должны включать формы как единственного, так и множественного числа, если это применимо. Каноническим названием настройки скорости будет считаться первый синоним в списке. |
[ item, ... ] | Нить | Синоним. |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
ordered | логическое значение | Необходимый. Если установлено значение true, будет применяться дополнительная грамматика для логики увеличения или уменьшения в порядке (возрастания) массива скоростей. |
1 | Объект | Поддержка процента скорости. |
supportsFanSpeedPercent | логическое значение | Необходимый. (По умолчанию: Если установлено значение 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 | Нить | Это внутреннее имя текущей настройки скорости из |
currentFanSpeedPercent | Число | Указывает текущую скорость вентилятора в процентах. Требуется, если для атрибута |
Примеры
Какая скорость вентиляторов в гостиной?
{ "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 fan speed to the AC до 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
- エアコンの風量を高速にセット
ко-КР
- 선풍기 강풍 으로 틀어 줘
НЛ-НЛ
- zet de snelheid van de ventilator op medium
пт-БР
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
св-ЮВ
- Ställ in fläkten på medel
ОШИБКИ устройства
Полный список ошибок и исключений смотрите .-
maxSpeedReached
: устройство уже настроено на максимальную скорость. -
minSpeedReached
: на устройстве уже установлена минимальная скорость.