스마트 홈 LightEffects 특성 스키마

action.devices.traits.LightEffects - 이 트레이트는 다양한 색상을 루프하는 등 상태를 변경하는 복잡한 조명 명령어를 지원할 수 있는 기기에 속합니다.

기기 속성

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

속성 유형 설명
defaultColorLoopDuration 정수

(기본값: 1800)

action.devices.commands.ColorLoop 명령어에 의해 트리거되는 효과의 기본 지속 시간(초)입니다.

값은 300에서 3600 사이여야 합니다.
defaultSleepDuration 정수

(기본값: 1800)

action.devices.commands.Sleep 명령어에 의해 트리거되는 효과의 기본 지속 시간(초)입니다.

값은 300에서 3600 사이여야 합니다.
defaultWakeDuration 정수

(기본값: 1800)

action.devices.commands.Wake 명령어에 의해 트리거되는 효과의 기본 지속 시간(초)입니다.

값은 300에서 3600 사이여야 합니다.
supportedEffects 배열

필수사항.

기기에서 지원하는 효과 목록입니다.
[item, ...] 문자열

지원되는 효과입니다.

지원되는 값:

colorLoop
다양한 색상을 무작위로 반복합니다.
sleep
밝기를 점차 낮추고 선택적으로 일정 기간 동안 색상 온도를 조정합니다.
wake
밝기를 점차 높이고 선택적으로 일정 기간 동안 색상 온도를 조정합니다.

예

색상 반복 효과를 지원하는 기기

{
  "supportedEffects": [
    "colorLoop"
  ]
}

수면/기상 효과를 지원하는 기기

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

기기 상태

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

주 유형 설명
activeLightEffect 문자열

현재 활성 상태인 조명 효과(있는 경우)입니다. supportedEffects 중 하나입니다.

지원되는 값:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec 정수

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

예

내 기기의 현재 효과는 무엇인가요?

{
  "activeLightEffect": "colorLoop"
}

내 기기의 현재 효과는 무엇인가요?

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

현재 활성 상태인 조명 효과가 없습니다.

{}

기기 명령어

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

action.devices.commands.ColorLoop

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

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

매개변수

매개변수 유형 설명
duration 정수

색상 반복 명령어의 지속 시간(초)입니다.

값은 300에서 3600 사이여야 합니다.

예

60분 동안 조명을 색상 반복해 줘.

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

action.devices.commands.Sleep

기기의 밝기를 점차 낮추고 선택적으로 일정 기간 동안 색상 온도를 조정합니다.

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

매개변수

매개변수 유형 설명
duration 정수

수면 명령어의 지속 시간(초)입니다(범위: 300~3600).

값은 300에서 3600 사이여야 합니다.

예

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 정수

기상 명령어의 지속 시간(초)입니다(범위: 300~3600).

값은 300에서 3600 사이여야 합니다.

예

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

기기 오류

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