스마트 홈 LightEffects Trait 스키마

action.devices.traits.LightEffects: 이 특성은 상태 변경을 위한 복잡한 조명 명령어를 지원할 수 있는 기기에 속합니다(예: 다양한 색상 반복).

기기 ATTRIBUTES

이 특성이 있는 기기는 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 정수

효과가 자체적으로 종료되는 경우 효과가 종료될 것으로 예상되는 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 정수

절전 모드 명령어의 지속 시간(초)입니다.

예시

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

기기 오류

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