스마트 홈 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, ...] String

지원되는 효과입니다.

지원되는 값:

colorLoop
다양한 색상을 무작위로 반복합니다.
sleep
밝기를 점진적으로 낮추고 원하는 경우 일정 시간 동안 색상 온도를 조정합니다.
wake
밝기를 점차적으로 높이고, 원하는 경우 일정 기간 동안 색상 온도를 조정합니다.

예

색상 루프 효과를 지원하는 기기

{
  "supportedEffects": [
    "colorLoop"
  ]
}

수면/기상 효과 지원 기기

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

기기 상태

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

주 유형 설명
activeLightEffect String

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

지원되는 값:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec 정수

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

예

현재 내 기기에 미치는 영향은 무엇인가요?

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

절전 명령어의 시간(단위: 초)입니다.

예

조명 절전 모드로 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 정수

웨이크 명령어의 기간(단위: 초)입니다.

예

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

기기 오류

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