สคีมาลักษณะเฉพาะของ LightEffects สำหรับสมาร์ทโฮม
action.devices.traits.LightEffects
- ลักษณะนี้เป็นของอุปกรณ์ที่รองรับคำสั่งเกี่ยวกับการจัดแสงที่ซับซ้อนเพื่อเปลี่ยนสถานะ เช่น การวนซ้ำของสีต่างๆ
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจรายงานสิ่งต่อไปนี้
เป็นส่วนหนึ่งของการดำเนินการ SYNC
เพื่อเรียนรู้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่
การจำหน่าย Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
defaultColorLoopDuration |
จำนวนเต็ม |
(ค่าเริ่มต้น: ระยะเวลาเริ่มต้นเป็นวินาทีสำหรับเอฟเฟกต์ที่ทริกเกอร์โดยคำสั่ง |
defaultSleepDuration |
จำนวนเต็ม |
(ค่าเริ่มต้น: ระยะเวลาเริ่มต้นเป็นวินาทีสำหรับเอฟเฟกต์ที่ทริกเกอร์โดยคำสั่ง |
defaultWakeDuration |
จำนวนเต็ม |
(ค่าเริ่มต้น: ระยะเวลาเริ่มต้นเป็นวินาทีสำหรับเอฟเฟกต์ที่ทริกเกอร์โดยคำสั่ง |
supportedEffects |
อาร์เรย์ |
ต้องระบุ รายการเอฟเฟกต์ที่อุปกรณ์รองรับ |
[item, ...] |
String |
เอฟเฟกต์ที่รองรับ ค่าที่รองรับ
|
ตัวอย่าง
อุปกรณ์รองรับเอฟเฟกต์ลูปสี
{ "supportedEffects": [ "colorLoop" ] }
อุปกรณ์ที่รองรับเอฟเฟกต์การนอนหลับ/ตื่น
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
สถานะของอุปกรณ์
เอนทิตีที่มีลักษณะนี้อาจรายงานสิ่งต่อไปนี้
สถานะเป็นส่วนหนึ่งของการดำเนินการ QUERY
เพื่อเรียนรู้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY
ได้ที่
การจำหน่าย Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
activeLightEffect |
String |
เอฟเฟกต์แสงที่ใช้งานอยู่ในปัจจุบัน หากมี หนึ่งใน ค่าที่รองรับ
|
lightEffectEndUnixTimestampSec |
จำนวนเต็ม |
การประทับเวลา Unix เมื่อคาดว่าเอฟเฟกต์จะสิ้นสุด หากเอฟเฟกต์สิ้นสุดเอง |
ตัวอย่าง
ผลกระทบปัจจุบันในอุปกรณ์ของฉันคืออะไร
{ "activeLightEffect": "colorLoop" }
ผลกระทบปัจจุบันในอุปกรณ์ของฉันคืออะไร
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
ไม่มีเอฟเฟกต์แสงที่ทำงานอยู่
{}
คำสั่งอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อสิ่งต่อไปนี้
เป็นส่วนหนึ่งของการดำเนินการ EXECUTE
เพื่อเรียนรู้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่
การจำหน่าย Intent
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
ลักษณะเฉพาะ
แพลตฟอร์มรองรับ "โหมดสลีป" ที่เลียนแบบ และ "ปลุก" โดยไม่ต้องใช้โค้ดเพิ่มเติม
แพลตฟอร์มจะจำลองเอฟเฟกต์โดยการส่งชุด 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