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