Схема параметров настройки цвета для умного дома

action.devices.traits.ColorSetting — Эта характеристика применяется к устройствам, таким как умные светильники, которые могут изменять цвет или цветовую температуру.

RGB, HSV и цветовая температура

RGB представляет цвета в виде триплета (красный, зеленый, синий). RGB — это цветовая модель по умолчанию. Любой триплет RGB может быть представлен в виде шестнадцатеричного кода, эквивалентного шестнадцатеричным значениям объединенного триплета. Например, «синий» — это (0, 0, 255) и #0000FF. Вы можете использовать любое значение в цветовом пространстве RGB; то есть RGB(x, y, z), где x, y, z находятся в диапазоне [0, 255] включительно.

HSV представляет цвета в виде триплета (оттенок, насыщенность, яркость). Любое значение цвета в HSV может быть преобразовано в RGB, и наоборот. Оттенок имеет диапазон [0, 360) градусов (исключая 360, поскольку он возвращается к 0 градусам). Насыщенность и яркость представлены числами с плавающей запятой в диапазоне [0,0, 1,0].

Цветовая температура представляет некоторые цвета в виде неотрицательных десятичных значений в Кельвинах. Этот атрибут описывает «белый» или «теплый» свет, с такими названиями цветов, как «холодный белый» или «пасмурный дневной свет». Умные светильники, поддерживающие цветовую температуру, обычно имеют диапазон [2000, 9000] Кельвинов, что соответствует обычным светильникам с фиксированной цветовой температурой. Цветовая температура представляет собой линейную шкалу и является подмножеством полноспектральных цветовых моделей RGB/HSV. В таблице ниже приведены примеры температур и соответствующие названия цветов.

АТРИБУТЫ УСТРОЙСТВА

Устройства с этой особенностью могут сообщать следующие атрибуты в рамках операции SYNC . Для получения дополнительной информации об обработке намерений SYNC см. раздел «Выполнение намерений» .

Примеры

Устройство, поддерживающее как цветовую модель RGB, так и цветовую температуру.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Устройство, поддерживающее только цветовую модель спектра HSV.

{
  "colorModel": "hsv"
}

Устройство, поддерживающее только цветовую температуру.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Устройство, поддерживающее только команды цветовой модели HSV.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

СОСТОЯНИЯ УСТРОЙСТВА

Сущности с этим свойством могут сообщать о следующих состояниях в рамках операции QUERY . Для получения дополнительной информации об обработке намерений QUERY см. раздел «Выполнение намерений» .

Примеры

Какого цвета этот свет? (Теплый белый)

{
  "color": {
    "temperatureK": 3000
  }
}

Какого цвета этот свет? (Пурпурный)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

Какого цвета этот свет? (Пурпурный)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

КОМАНДЫ УСТРОЙСТВА

Устройства с этой особенностью могут реагировать на следующие команды в рамках операции EXECUTE . Для получения дополнительной информации об обработке намерений EXECUTE см. раздел «Выполнение намерений» .

action.devices.commands.ColorAbsolute

Задайте абсолютное значение цвета.

Параметры

Примеры

Сделайте свет теплым белым.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

Сделайте свет пурпурным.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

Сделайте свет пурпурным.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

Обратите внимание, что названия параметров немного различаются между параметрами команд и состояния. Это позволяет избежать конфликтов с параметрами состояния для устаревших характеристик ColorSpectrum и ColorTemperature .

Примеры высказываний

ОШИБКИ устройства