Схема характеристик 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
en-US
- drop скорость the AC fan speed to medium
эс-эс
- cambia la velocidad del ventilador дель вентиладор a medio
а как
- au mets la ventilation maximum
привет-IN
- बेडरूम में पंखे की गति मीडियम करें
это-это
- metti il condizionatore in salotto a velocità media
ja-JP
- エアコンの風量を高速にセット
ко-КР
- 선풍기 강풍 으로 틀어 줘
нл-нл
- zet de snelheid van de ventilator op medium
пт-BR
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
св-СЭ
- Ställ in fläkten på medel
ОШИБКИ устройства
См. полный список ошибок и исключений .-
maxSpeedReached
: устройство уже настроено на максимальную скорость. -
minSpeedReached
: устройство уже настроено на минимальную скорость.