스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.

스마트 홈 조명 효과 특성 스키마

action.devices.traits.LightEffects: 이 특성은 다양한 색상을 순환하는 것과 같이 상태를 변경하기 위해 복잡한 조명 명령을 지원할 수 있는 기기에 속합니다.

기기 속성

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

속성 유형 설명
defaultColorLoopDuration 정수

(기본값: 1800)

action.devices.commands.ColorLoop 명령어로 트리거된 효과의 기본 기간(초)입니다.

defaultSleepDuration 정수

(기본값: 1800)

action.devices.commands.Sleep 명령어로 트리거된 효과의 기본 기간(초)입니다.

defaultWakeDuration 정수

(기본값: 1800)

action.devices.commands.Wake 명령어로 트리거된 효과의 기본 기간(초)입니다.

supportedEffects 배열

필수.

기기에서 지원하는 효과 목록입니다.

[item, ...] String

지원되는 효과입니다.

지원되는 값:

colorLoop
다양한 색상을 무작위로 순환합니다.
sleep
시간이 지남에 따라 점차적으로 밝기를 낮추고 색 온도를 조정합니다.
wake
시간이 지남에 따라 점진적으로 밝기를 높이고 색상 온도를 조정합니다.

색상 순환 효과를 지원하는 기기

{
  "supportedEffects": [
    "colorLoop"
  ]
}

수면/깨우기 효과를 지원하는 기기

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

기기 상태: STATES

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

상태 유형 설명
activeLightEffect String

현재 활성화된 빛 효과입니다. supportedEffects 중 하나

지원되는 값:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec 정수

효과가 자체적으로 종료될 경우 효과가 종료될 것으로 예상되는 Unix 타임스탬프입니다.

현재 내 기기에 어떤 영향이 있나요?

{
  "activeLightEffect": "colorLoop"
}

현재 내 기기에 어떤 영향이 있나요?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

현재 활성화된 조명 효과가 없습니다.

{}

기기 COMMANDS

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

action.devices.commands.ColorLoop

색상 세트를 차례로 순환하도록 기기를 요청합니다.

이 명령어에는
{
  "supportedEffects": [
    "colorLoop"
  ]
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
duration 정수

색상 루프 명령어의 기간(초)입니다.

조명 60분 동안 색상 반복 사용

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

기기의 밝기를 점차 낮추고 원하는 경우 색상 온도를 조정합니다.

이 명령어에는
{
  "supportedEffects": [
    "sleep"
  ]
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
duration 정수

절전 모드 지속 시간(초)입니다.

조명을 60분 동안 절전 모드로 전환합니다.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

현재 조명 효과를 중지합니다.

매개변수

매개변수 유형 설명

속성이 없습니다.

조명에 효과 중지해 줘.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

기기의 밝기를 점차 높이고 원하는 경우 색상 온도를 선택적으로 조정합니다.

이 명령어에는
{
  "supportedEffects": [
    "wake"
  ]
}
속성이 필요합니다.

매개변수

매개변수 유형 설명
duration 정수

wake 명령어 지속 시간(초)

조명 60분 동안 켜 줘.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

조명 효과 에뮬레이션

기기에서 Brightness 특성은 구현하지만 LightEffects 특성은 구현하지 않는 경우 플랫폼은 추가 코드 없이 에뮬레이션된 '절전' 및 '절전' 효과를 지원합니다. 플랫폼은 일련의 EXECUTE 인텐트를 전송하여 효과를 에뮬레이션합니다.

샘플 발화

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

기기 ERRORS

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