Схема свойств умного дома ColorSetting
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 aufblau - Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
- can you adjust
my lights color to4000 kelvins - set
the lights toblue
эс-эс
- pon
azul la luz de la cocina - pon
la luz a2000 k de temperatura de color
а как
- Allume
la lampe de la chambre à3500 kelvins . - mets
les lampes enrose dansla chambre
привет-IN
- तुम
लाइट कोब्लू कर दो लैम्प 2000 केल्विन पर लगाओ।
это-это
- Imposta
la lampada a2000 K . - metti
la luce gialla
ja-JP
照明 の色を青 にして照明 の色温度を5000K にセットして
ко-КР
조명 색깔흰색 으로 바꿔 줘주방 전등 색 온도를5000 켈빈 으로 설정해
нл-нл
- Zet
de keukenlamp op2000 Kelvin . - maak
het licht rood
пт-BR
- Colocar
a lâmpada em2000 K . - Define
a lâmpada para2000 K . - colocar
a luz da sala emazul - põe
a luz da sala avermelho
св-СЭ
- Ställ in
lampan på2000 Kelvin - tänd
blått ljus i köket