스마트 홈 LightEffects 특성 스키마

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, ...] 문자열

지원되는 효과입니다.

지원되는 값:

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

색상 루프 명령의 지속 시간(초)입니다.

예

60분 동안 조명을 컬러루프로 설정해 줘.

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

action.devices.commands.Sleep

일정 시간 동안 기기의 밝기를 점진적으로 낮추고 원하는 경우 색상 온도를 조정합니다.

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

매개변수

매개변수 유형 설명
duration 정수

대기 명령의 지속 시간(초)(범위: 300~3,600)입니다.

예

조명을 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~3,600)입니다.

예

60분 동안 조명을 켜 줘.

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

조명 효과 에뮬레이션

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

샘플 발화

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

기기 오류

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