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

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. В таблице ниже приведены примеры температур и соответствующие названия цветов.

Температура (Кельвин) Название цвета
2000 г. Свеча Свет
2500 Ультра теплый белый
3000 Мягкий белый, утренний белый, белый для чтения
4000 Холодный белый
5000 Дневной Свет, Белый
6000 Цветочный Белый
7000 Пасмурный дневной свет, белый дым
8000 Синий пасмурно
9000 Голубое небо

АТРИБУТЫ устройства

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

Атрибуты Тип Описание
commandOnlyColorSetting логическое значение

(По умолчанию: false )

Указывает, поддерживает ли устройство использование односторонней (истинной) или двусторонней (ложной) связи. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или состояние отчета для этого признака.

Содержит любой из следующих элементов:
0 Объект

Поддержка цветовых моделей.

colorModel Нить

Необходимый.

Цветовая модель полного спектра, поддерживаемая устройством.

Поддерживаемые значения:

rgb
hsv
1 Объект

Поддержка цветовой температуры.

colorTemperatureRange Объект

Необходимый.

Поддерживаемый диапазон цветовой температуры в Кельвинах.

temperatureMinK Целое число

Необходимый.

Минимальная поддерживаемая цветовая температура в Кельвинах.

temperatureMaxK Целое число

Необходимый.

Максимальная поддерживаемая цветовая температура в Кельвинах.

Примеры

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

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

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

{
  "colorModel": "hsv"
}

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

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

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

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

СОСТОЯНИЯ устройства

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

состояния Тип Описание
color Объект

Необходимый.

Текущая настройка цвета, используемая в данный момент на устройстве.

Содержит один из следующих элементов:
0 Объект

Поддержка цветовой температуры.

temperatureK Целое число

Необходимый.

Значение температуры в Кельвинах.

1 Объект

Поддержка цветового спектра RGB.

spectrumRgb Целое число

Необходимый.

Значение спектра RGB в виде десятичного целого числа.

2 Объект

Поддержка цветового спектра HSV.

spectrumHsv Объект

Необходимый.

Значение спектра HSV.

hue Число

Хюэ.

saturation Число

Насыщенность.

value Число

Ценить.

Примеры

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

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

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

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

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

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

КОМАНДЫ устройства

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

action.devices.commands.ColorAbsolute

Установите абсолютное значение цвета.

Параметры

Параметры Тип Описание
color Объект

Необходимый.

Цвет для установки.

name Нить

Название цвета, полученное из команды пользователя; может быть не всегда доступен (т.е. при использовании относительных команд).

Содержит один из следующих элементов:
0 Объект

Поддержка цветовой температуры.

temperature Целое число

Необходимый.

Значение температуры в Кельвинах. Подробности см. в разделах RGB, HSV и цветовая температура .

1 Объект

Поддержка цветового спектра RGB.

spectrumRGB Целое число

Необходимый.

Значение спектра RGB в виде десятичного целого числа. Подробности см. в разделах RGB, HSV и цветовая температура .

2 Объект

Поддержка цветового спектра HSV.

spectrumHSV Объект

Необходимый.

Значение спектра HSV. Подробности см. в разделах RGB, HSV и цветовая температура .

hue Число

Хюэ.

saturation Число

Насыщенность.

value Число

Ценить.

Примеры

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

{
  "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 .

Команда Состояние
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

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

де-DE

  • Stell die Farbe der Lampe auf blau
  • Stelle die Farbtemperatur auf 3000 Kelvin ein.

ru-US

  • can you adjust цвет my lights color to 4000 kelvins ?
  • set the lights to blue

эс-ES

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

а как

  • Allume la lampe de la chambre . à 3500 kelvins
  • mets les lampes en rose dans la chambre

привет-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

это-ИТ

  • Imposta . la lampada a 2000 K
  • metti la luce gialla

ja-JP

  • 照明の色を青にして
  • 照明の色温度を5000Kにセットして

ко-КР

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

нл-нл

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

пт-БР

  • Colocar a lâmpada em 2000 K .
  • . Define a lâmpada para 2000 K
  • colocar em azul a luz da sala -Эм-Азул
  • põe a luz da sala vermelho a

св-ЮВ

  • Ställ in lampan på 2000 Kelvin
  • tänd blått ljus i köket

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

Полный список ошибок и исключений смотрите .