Эта страница переведена с помощью Cloud Translation API.

Схема свойств умного дома 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`	логический	(По умолчанию: `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
    }
  }
}

Примечание. При использовании состояния отчета для признака ColorSetting убедитесь, что вы указали состояние RGB как spectrumRGB и состояние HSV как spectrumHsv . (Вы должны использовать именно эту заглавную букву для имен состояний.)

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

Устройства с этой чертой могут отвечать на следующие команды как часть операции 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.

en-US

can you adjust my lights color to 4000 kelvins
set the lights to blue

эс-эс

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

пт-BR

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 a vermelho

св-СЭ

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

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

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