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

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

기기 오류

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