이 페이지는 Cloud Translation API를 통해 번역되었습니다.

스마트 홈 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	(기본값: `false`) 기기가 단방향 (true) 또는 양방향 (false) 통신을 사용하도록 지원하는지 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요.
다음 항목 포함:
`0`	객체	색상 모델 지원
`colorModel`	String	필수. 기기에서 지원하는 전체 스펙트럼 색상 모델입니다. 지원 값: `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 값을 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
    }
  }
}

참고: ColorSetting 특성에 보고서 상태를 사용할 때는 RGB 상태를 spectrumRGB로, HSV 상태를 spectrumHsv으로 지정해야 합니다. 주 이름에는 대문자를 정확히 사용해야 합니다.

기기 명령어

이 특성이 있는 기기는 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 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

es-ES

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

fr-FR

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

hi-IN

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

it-IT

Imposta la lampada a 2000 K .
metti la luce gialla

ja-JP

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

ko-KR

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

nl-NL

Zet de keukenlamp op 2000 Kelvin .
maak het licht rood

pt-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

sv-SE

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

기기 오류

오류 및 예외의 전체 목록을 참조하세요.