open_percentage

Last updated on April 4, 2025

Data type: INTEGER(0, 100).

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

Purpose: manages the device's opening It takes values from the range of 0-100% at an interval of 5%. 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

• curtain – curtains.
• gate – gates.
• valve – motorized valves.
• window_blind – louvered blinds, roll blinds.

Examples of voice commands

— Салют, распахни ворота на 90% (Salute, open the gate at 90%)

— Салют, раздвинь шторы наполовину (Salute, open the half of the curtains)

— Салют, опусти рулонные шторы на две трети (Salute, close roller blinds at two thirds)

Function description for a device model

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

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

Function state description example

In this example, the device is opened at 30%.

{
    "states": [
        {
            "key": "open_percentage",
            "value": {
                "type": "INTEGER",
                "integer_value": "30"
            }
        }
    ]
}