스마트 홈 ColorSetting 특성 스키마
action.devices.traits.ColorSetting
: 이 특성은 색상이나 색상 온도를 변경할 수 있는 기기(예: 스마트 조명)에 적용됩니다.
RGB, HSV, 색상 온도
RGB는 색상을 (빨간색, 녹색, 파란색) 3색으로 나타냅니다. RGB는 기본 색상 모델입니다. 모든 RGB 3색은 3진수 16진수 값에 상응하는 16진수 코드로 표현될 수 있습니다. 예를 들어 'blue'는 (0, 0, 255) 및 #0000FF입니다. RGB 색상 공간 내의 모든 값을 사용할 수 있습니다. 즉, RGB(x, y, z)에서 x, y, z는 [0, 255] 범위 내에 있습니다.
HSV는 색상을 (색조, 채도, 값) 3줄로 나타냅니다. HSV의 모든 색상 값은 RGB로 변환될 수 있으며 그 반대의 경우도 마찬가지입니다. 색조의 범위는 [0, 360)입니다 (약 0도까지 래핑되므로 360은 제외). 채도와 값은 [0.0, 1.0] 범위의 부동 소수점 수로 표시됩니다.
색상 온도는 일부 색상을 켈빈에서 음수가 아닌 십진수 값으로 나타냅니다. 이 속성은 '흰색' 또는 '따뜻한' 조명에 대해 설명하며, '냉방광'이나 '흐린 일광'과 같은 색상 이름을 지정합니다. 색상 온도를 지원하는 스마트 조명의 범위는 일반적으로 [2000, 9000] 켈빈이며, 고정된 켈빈이 있는 기존 조명에 해당합니다. 색상 온도는 선형 배율이며 RGB/HSV 전체 스펙트럼 색상 모델의 하위 집합입니다. 몇 가지 예시 온도와 해당하는 색상 이름은 아래 표를 참고하세요.
온도 (켈빈) | 색상 이름 |
---|---|
2,000 | 촛불 |
2500 | 울트라 웜 화이트 |
3,000 | 소프트 화이트, 모닝 화이트, 리딩 화이트 |
4,000 | 쿨 화이트 |
5,000 | 주간 조명(화이트) |
6,000 | 플로럴 화이트 |
7,000 | 흐린 주간 조명, 흰색 연기 |
8,000 | 파란색 흐림 |
9,000 | 블루 스카이 |
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
commandOnlyColorSetting |
Boolean |
(기본값: 기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요. |
다음 항목 포함: | ||
0
|
객체 |
색상 모델 지원 |
colorModel |
String |
필수. 기기에서 지원하는 전체 스펙트럼 색상 모델입니다. 지원 값:
|
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 값을 10진수 정수로 |
2
|
객체 |
색상 HSV 스펙트럼을 지원합니다. |
spectrumHsv |
객체 |
필수. 스펙트럼 HSV 값입니다. |
hue |
Number |
색조 |
saturation |
Number |
채도. |
value |
Number |
값. |
예
표시등의 색상은 무엇인가요? (웜 화이트)
{ "color": { "temperatureK": 3000 } }
표시등의 색상은 무엇인가요? (자홍색)
{ "color": { "spectrumRgb": 16711935 } }
표시등의 색상은 무엇인가요? (자홍색)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.ColorAbsolute
절대 색상 값을 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
color |
객체 |
필수. 설정할 색상입니다. |
name |
String |
사용자 명령어에서 파싱된 색상 이름입니다. 상대 명령어를 사용할 때 항상 사용하지 못할 수도 있습니다. |
다음 항목 중 하나 포함: | ||
0
|
객체 |
색상 온도 지원 |
temperature |
정수 |
필수. 온도 값(켈빈) 자세한 내용은 RGB, HSV 및 색상 온도를 참고하세요. |
1
|
객체 |
색상 RGB 스펙트럼을 지원합니다. |
spectrumRGB |
정수 |
필수. 스펙트럼 RGB 값을 10진수 정수로 자세한 내용은 RGB, HSV 및 색상 온도를 참고하세요. |
2
|
객체 |
색상 HSV 스펙트럼을 지원합니다. |
spectrumHSV |
객체 |
필수. 스펙트럼 HSV 값입니다. 자세한 내용은 RGB, HSV 및 색상 온도를 참고하세요. |
hue |
Number |
색조 |
saturation |
Number |
채도. |
value |
Number |
값. |
예
조명을 따뜻한 흰색으로 만듭니다.
{ "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-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
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-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
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket