สคีมาลักษณะการทำงาน LightEffects ของอุปกรณ์สมาร์ทโฮม

action.devices.traits.LightEffects - ลักษณะการทำงานนี้เป็นของอุปกรณ์ที่รองรับคำสั่งแสงที่ซับซ้อนเพื่อเปลี่ยนสถานะ เช่น การวนซ้ำสีต่างๆ

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะการทำงานนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่ การดำเนินการตาม Intent

Attributes Type Description
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, ...] String

เอฟเฟกต์ที่รองรับ

ค่าที่รองรับมีดังนี้

colorLoop
วนซ้ำสีต่างๆ แบบสุ่ม
sleep
ค่อยๆ ลดความสว่างและปรับอุณหภูมิสีในช่วงระยะเวลาหนึ่ง (ไม่บังคับ)
wake
ค่อยๆ เพิ่มความสว่างและปรับอุณหภูมิสีในช่วงระยะเวลาหนึ่ง (ไม่บังคับ)

ตัวอย่าง

อุปกรณ์ที่รองรับเอฟเฟกต์การวนซ้ำสี

{
  "supportedEffects": [
    "colorLoop"
  ]
}

อุปกรณ์ที่รองรับเอฟเฟกต์การนอน/ตื่น

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

สถานะของอุปกรณ์

เอนทิตีที่มีลักษณะการทำงานนี้อาจรายงานสถานะต่อไปนี้ เป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่ การดำเนินการตาม Intent

States Type Description
activeLightEffect String

เอฟเฟกต์แสงที่ใช้งานอยู่ในปัจจุบัน (หากมี) ค่าใดค่าหนึ่งจาก supportedEffects

ค่าที่รองรับมีดังนี้

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec จำนวนเต็ม

การประทับเวลา Unix เมื่อคาดว่าเอฟเฟกต์จะสิ้นสุดลง หากเอฟเฟกต์สิ้นสุดลงเอง

ตัวอย่าง

เอฟเฟกต์ปัจจุบันในอุปกรณ์ของฉันคืออะไร

{
  "activeLightEffect": "colorLoop"
}

เอฟเฟกต์ปัจจุบันในอุปกรณ์ของฉันคืออะไร

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

ไม่มีเอฟเฟกต์แสงที่ใช้งานอยู่ในปัจจุบัน

{}

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะการทำงานนี้อาจตอบสนองต่อคำสั่งต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม Intent

action.devices.commands.ColorLoop

ขอให้อุปกรณ์วนซ้ำชุดสี

คำสั่งนี้ต้องมีแอตทริบิวต์ต่อไปนี้
{
  "supportedEffects": [
    "colorLoop"
  ]
}

พารามิเตอร์

Parameters Type Description
duration จำนวนเต็ม

ระยะเวลาสำหรับคำสั่งการวนซ้ำสีเป็นวินาที

ค่าต้องอยู่ระหว่าง 300 ถึง 3600

ตัวอย่าง

วนซ้ำสีไฟของฉันเป็นเวลา 60 นาที

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

action.devices.commands.Sleep

ค่อยๆ ลดความสว่างของอุปกรณ์และปรับอุณหภูมิสีในช่วงระยะเวลาหนึ่ง (ไม่บังคับ)

คำสั่งนี้ต้องมีแอตทริบิวต์ต่อไปนี้
{
  "supportedEffects": [
    "sleep"
  ]
}

พารามิเตอร์

Parameters Type Description
duration จำนวนเต็ม

ระยะเวลาสำหรับคำสั่งการนอนเป็นวินาทีในช่วง 300 ถึง 3600

ค่าต้องอยู่ระหว่าง 300 ถึง 3600

ตัวอย่าง

ทำให้ไฟของฉันนอนเป็นเวลา 60 นาที

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

action.devices.commands.StopEffect

หยุดเอฟเฟกต์แสงปัจจุบัน

พารามิเตอร์

Parameters Type Description

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

หยุดเอฟเฟกต์ในไฟของฉัน

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

ค่อยๆ เพิ่มความสว่างของอุปกรณ์และปรับอุณหภูมิสีในช่วงระยะเวลาหนึ่ง (ไม่บังคับ)

คำสั่งนี้ต้องมีแอตทริบิวต์ต่อไปนี้
{
  "supportedEffects": [
    "wake"
  ]
}

พารามิเตอร์

Parameters Type Description
duration จำนวนเต็ม

ระยะเวลาสำหรับคำสั่งการปลุกระบบเป็นวินาทีในช่วง 300 ถึง 3600

ค่าต้องอยู่ระหว่าง 300 ถึง 3600

ตัวอย่าง

ทำให้ไฟของฉันตื่นเป็นเวลา 60 นาที

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

การจำลองเอฟเฟกต์แสง

หากอุปกรณ์ของคุณใช้ลักษณะการทำงาน Brightness แต่ไม่ใช่ลักษณะการทำงาน LightEffects แพลตฟอร์มจะรองรับเอฟเฟกต์ "การนอน" และ "การตื่น" ที่จำลองขึ้นโดยไม่จำเป็นต้องใช้โค้ดเพิ่มเติม แพลตฟอร์มจะจำลองเอฟเฟกต์โดยส่งชุด Intent 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

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด