light

Осветительное устройство, которым можно управлять. Примеры:

  • Лампочка
  • Ночник

Доступные функции устройства

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если умная лампа не умеет менять температуру цвета, включать функцию light_colour_temp в описание ее модели не нужно.

Некоторые функции обязательные: они должны быть у всех ламп.

Функция Обязательная? Описание
online ✔︎ Доступность устройства: офлайн или онлайн
on_off ✔︎ Удаленное включение и выключение устройства
light_mode Режим работы устройства: цветной или белый цвет
light_brightness Яркость устройства
light_colour Цвет устройства
light_colour_temp Температура цвета устройства

Пример описания модели лампы

Модель описывается в соответствии со структурой model. В примере описана лампа, которая может включаться и выключаться удаленно, поддерживает белый и цветной режим работы, умеет менять яркость, цвет и цветовую температуру. У лампы есть таймер выключения.

Кроме того, для модели описана зависимость функции light_colour (цвет освещения) от функции light_mode (режим работы): менять цвет лампы можно, только если она переключена в цветной режим работы.

{
    "id": "QWERTY123",
    "manufacturer": "Xiaqara",
    "model": "SM0123456789",
    "hw_version": "3.2",
    "sw_version": "5.7",
    "description": "Умная лампа Xiaqara",
    "category": "light",
    "features": [
        "online",
        "on_off",
        "light_mode",
        "light_brightness",
        "light_colour",
        "light_colour_temp",
        "sleep_timer"
    ],
    "dependencies": {
        "light_colour": {
        "key": "light_mode",
            "values": [
                {
                    "type": "ENUM",
                    "enum_value": "colour"
                }
            ]
        }
    }
}

Пример описания лампы пользователя

Устройство описывается в соответствии со структурой device. В примере нет описания модели лампы — считаем, что модели описаны отдельно, поэтому достаточно указать только ID модели (здесь — QWERTY123).

{
    "id": "ABCD_003",
    "parent_id": "A_001",
    "name": "Моя лампа",
    "default_name": "Умная лампа",
    "nicknames": [
        "Светодиодная лампа",
        "Смарт-лампа"
    ],
    "home": "Мой дом",
    "room": "Гостиная",
    "groups": [
      "Верхний свет",
      "Ниши",
    ],
    "model_id": "QWERTY123",
    "hw_version": "3.2",
    "sw_version": "5.7"
}

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней