สคีมาลักษณะเฉพาะของ LightEffects สำหรับสมาร์ทโฮม

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

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

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

Attributes ประเภท คำอธิบาย
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 เพื่อเรียนรู้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่ การจำหน่าย Intent

รัฐ ประเภท คำอธิบาย
activeLightEffect String

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

ค่าที่รองรับ

colorLoop
sleep
wake
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

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

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