스마트 홈 ColorSetting 특성 스키마

action.devices.traits.ColorSetting: 이 특성은 색상이나 색상 온도를 변경할 수 있는 스마트 조명과 같은 기기에 적용됩니다.

RGB, HSV 및 색상 온도

RGB는 색상을 (빨간색, 녹색, 파란색) 3색으로 나타냅니다. RGB는 기본 색상 모델입니다. 모든 RGB 3색은 연결된 3개의 16진수 값과 동일한 16진수 코드로 표시될 수 있습니다. 예를 들어 '파란색'은 (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 전체 스펙트럼 색상 모델의 하위 집합입니다. 온도와 그에 상응하는 색상 이름의 예는 아래 표를 참고하세요.

온도 (켈빈) 색상 이름
2000촛불
2500울트라 웜 화이트
3,000소프트 화이트, 모닝 화이트, 리딩 화이트
4000쿨 화이트
5000일광, 흰색
6000플로럴 화이트
7,000흐린 일광, 흰색 연기
8000푸른 흐린 하늘
9,000푸른하늘

기기 ATTRIBUTES

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

필수.

10진수로 표시된 스펙트럼 RGB 값입니다.
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 정수

필수.

10진수로 표시된 스펙트럼 RGB 값입니다. 자세한 내용은 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

기기 오류

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