Схема параметров настройки цвета умного дома
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 | логическое значение | (По умолчанию: Указывает, поддерживает ли устройство использование односторонней (истинной) или двусторонней (ложной) связи. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или состояние отчета для этого признака. |
Содержит любой из следующих элементов: | ||
0 | Объект | Поддержка цветовых моделей. |
colorModel | Нить | Необходимый. Цветовая модель полного спектра, поддерживаемая устройством. Поддерживаемые значения:
|
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 2000 k a 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 켈빈 으로 설정해
НЛ-НЛ
- de keukenlamp Zet op 2000 Kelvin .
- maak het licht rood
пт-БР
- Colocar a lâmpada em 2000 K .
- Define . a lâmpada para 2000 K
- colocar a luz da sala em azul
- põe a luz da sala vermelho a
св-ЮВ
- Ställ in lampan på 2000 Kelvin
- tänd blått ljus i köket