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

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 .

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

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