light_brightness

Last updated on June 17, 2024

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, the range and interval of values taken by the function can be changed.

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"
            }
        }
    ]
}