스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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
    }
  }
}

기기 명령어

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

action.devices.commands.ColorAbsolute

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

매개변수

매개변수 유형 설명
color 객체

필수.

설정할 색상입니다.

name String

사용자 명령어에서 파싱된 색상 이름입니다. 상대 명령어를 사용할 때 항상 사용하지 못할 수도 있습니다.

다음 항목 중 하나 포함:
0 객체

색상 온도 지원

temperature 정수

필수.

온도 값(켈빈)

1 객체

색상 RGB 스펙트럼을 지원합니다.

spectrumRGB 정수

필수.

스펙트럼 RGB 값을 10진수 정수로

2 객체

색상 HSV 스펙트럼을 지원합니다.

spectrumHSV 객체

필수.

스펙트럼 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
      }
    }
  }
}

매개변수 이름은 명령어 매개변수와 상태 매개변수 간에 약간 다릅니다. 이렇게 하면 지원 중단된 ColorSpectrumColorTemperature 특성의 상태 매개변수와의 충돌을 방지합니다.

명령어 상태
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 2000 Kelvin
  • tänd blått ljus i köket

기기 오류

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