스마트 홈 ColorSetting 트레잇 스키마

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

RGB, HSV, 색상 온도

RGB는 색상을 (빨강, 녹색, 파랑) 3중으로 나타냅니다. RGB는 기본 색상 모델입니다. 모든 RGB 삼중항은 연결된 삼중항의 16진수 값과 동일한 16진수 코드로 표현할 수 있습니다. 예를 들어 'blue'는 (0, 0, 255) 및 #0000FF입니다. RGB 색상 공간 내의 모든 값을 사용할 수 있습니다. 즉, x, y, z가 [0, 255] 범위(양 끝값 포함)에 있는 RGB(x, y, z)를 사용할 수 있습니다.

HSV는 색상을 (색조, 채도, 값) 3중으로 나타냅니다. HSV의 모든 색상 값은 RGB로 변환할 수 있으며 그 반대의 경우도 가능합니다. 색조의 범위는 [0, 360)도입니다(0도로 다시 돌아가므로 360도는 제외). 채도와 값은 [0.0, 1.0] 범위의 부동 소수점으로 표시됩니다.

색상 온도는 일부 색상을 음수가 아닌 십진수 켈빈 값으로 나타냅니다. 이 속성은 '흰색' 또는 '따뜻한 색상' 조명을 '차가운 흰색' 또는 '흐린 날의 일광'과 같은 색상 이름으로 설명합니다. 색온도를 지원하는 스마트 조명은 일반적으로 [2000, 9000] 켈빈 범위를 가지며 이는 고정 켈빈의 기존 조명에 해당합니다. 색온도는 선형 척도이며 RGB/HSV 전체 스펙트럼 색상 모델의 하위 집합입니다. 온도와 해당 색상 이름의 예는 아래 표를 참고하세요.

온도 (켈빈) 색상 이름
2000캔들 라이트
2500울트라 웜 화이트
3000소프트 화이트, 모닝 화이트, 리딩 화이트
4000주백색
5000주간 조명, 흰색
6000플로럴 화이트
7000흐린 날의 빛, 흰색 연기
8000파란색 흐린 하늘
9,000푸른 하늘

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
commandOnlyColorSetting Boolean

(기본값: false)

기기가 단방향(true) 또는 양방향(false) 통신 사용을 지원하는지 나타냅니다. 기기가 이 트레잇의 QUERY 인텐트 또는 Report State에 응답할 수 없는 경우 이 속성을 true로 설정합니다.
다음 항목 중 하나를 포함합니다.
0 객체

색상 모델 지원
colorModel String

필수사항.

기기에서 지원하는 전체 스펙트럼 색상 모델입니다.

지원되는 값:

rgb
hsv
1 객체

색상 온도 지원
colorTemperatureRange 객체

필수사항.

지원되는 색상 온도 범위(켈빈)
temperatureMinK 정수

필수사항.

지원되는 최소 색상 온도이며 단위는 켈빈(K)입니다.
temperatureMaxK 정수

필수사항.

지원되는 최대 색상 온도이며 단위는 켈빈(K)입니다.

예

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

조명은 어떤 색상인가요? (Magenta)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

조명은 어떤 색상인가요? (Magenta)

{
  "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 숫자

색조
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-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

기기 오류

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