light_brightness (яркость)

Обновлено 4 апреля 2025

Тип данных: INTEGER(50,1000).

Способ использования: хранит состояние устройства и может менять его.

Назначение: определяет яркость света. Принимает значения от 50 до 1000 с шагом 1. При описании модели устройства можно уменьшить диапазон принимаемых функцией значений либо изменить их шаг. Подробнее см. в разделе Допустимые значения функций.

Устройства с этой функцией

• led_strip — светодиодные ленты.
• light — лампы, ночники и т. д.

Примеры голосовых команд

— Салют, увеличь яркость лампы

— Салют, убавь яркость люстры на 30%

— Салют, сделай яркость ночной подсветки на минимум

Если пользователь отдал команду в процентах, значение яркости необходимо вычислить исходя из того, что 1% равен 10 единицам яркости. Таким образом, например:

• По команде «Салют, убавь яркость люстры на 30%» яркость должна быть уменьшена на 300.
• По команде «Салют, сделай яркость люстры на 50%» яркость должна быть установлена как 500.

Описание функции в модели устройства

Функция должна быть добавлена в описания моделей всех поддерживающих ее устройств.

"features": [
    "light_brightness",
    // ...
 ]

Пример описания состояния функции

В примере описано устройство, яркость которого установлена на 50% от максимальной.

{
    "states": [
        {
            "key": "light_brightness",
            "value": {
                "type": "INTEGER",
                "integer_value": "500"
            }
        }
    ]
}