스마트 홈 ColorSetting 특성 스키마

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

RGB, HSV, 색상 온도

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

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

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

기기 속성

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

예

RGB 스펙트럼 색상 모델과 색상 온도를 모두 지원하는 기기.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

HSV 스펙트럼 색상 모델만 지원하는 기기.

{
  "colorModel": "hsv"
}

색상 온도만 지원하는 기기.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

HSV 색상 모델 명령어만 지원하는 기기.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

기기 상태

이 특성이 있는 항목은 다음 상태를 QUERY 작업의 일부로 보고할 수 있습니다. `QUERY` 인텐트 처리에 관한 자세한 내용은 인텐트 처리하기를 참고하세요.

예

조명 색상은 무엇인가요? (전구색)

{
  "color": {
    "temperatureK": 3000
  }
}

조명 색상은 무엇인가요? (자홍색)

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

조명 색상은 무엇인가요? (자홍색)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

기기 명령어

이 특성이 있는 기기는 다음 명령어에 EXECUTE 작업의 일부로 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리하기를 참고하세요.

action.devices.commands.ColorAbsolute

절대 색상 값을 설정합니다.

매개변수

예

조명을 전구색으로 해 줘.

{
  "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 특성의 상태 매개변수와의 충돌을 방지할 수 있습니다.

샘플 발화

기기 오류