light_brightness

Last updated on April 4, 2025

Data type: INTEGER(50,1000).

Usage method: stores the device state and can change it.

Purpose: determines the light intensity. It takes values from the range of 50-1,000 at an interval of 1. When describing the device model, you can shorten the range of values accepted by the function or change their interval. For more information, see Allowed values of functions.

Devices with this function

• led_strip – LED strips.
• light – lamps, night lights, etc.

Examples of voice commands

— Салют, увеличь яркость лампы (Salute, increase the light intensity of the lamp)

— Салют, убавь яркость люстры на 30% (Salute, reduce the chandelier brightness by 30%)

— Салют, сделай яркость ночной подсветки на минимум (Salute, reduce the night light intensity to the minimum level)

If the user’s command indicates a percentage, the brightness (light intensity) value needs to be calculated based on the fact that 1% is equal to 10 brightness units. Thus, for example:

• The command «Салют, убавь яркость люстры на 30%» ("Salute, reduce the chandelier brightness by 30%") must reduce the brightness by 300.
• The command «Салют, сделай яркость люстры на 50%» ("Salute, set the chandelier brightness at 50%") must set the brightness at 500.

Function description for a device model

The function must be added to the model descriptions of all devices that support it.

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

Function state description example

The example describes a device with the light intensity at 50% of the maximum level.

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