คําสั่งความสว่าง

คำอธิบาย

ปรับความสว่างสัมพัทธ์ของอุปกรณ์ เมื่อตั้งค่าความสว่างเป็นค่าที่มากกว่า 0 หากอุปกรณ์ปิดอยู่ อุปกรณ์จะเปิดขึ้น และ OnOffState.state จะเปลี่ยนเพื่อแสดงว่าอุปกรณ์เปิดอยู่ ในทำนองเดียวกัน เมื่อตั้งค่าความสว่างเป็น 0 อุปกรณ์จะปิดเครื่องและ OnOffState.state จะเปลี่ยนตามไปด้วย

ช่อง

คีย์	ประเภท	คำอธิบาย
devices	[อุปกรณ์]	อุปกรณ์ เช่น หลอดไฟที่รองรับการเปลี่ยนความสว่าง ต้องระบุ
brightnessRelativePercent	Number	เปอร์เซ็นต์ความสว่างที่แน่นอนที่จะเปลี่ยน ไม่บังคับ หากใช้ฟิลด์นี้ คุณจะไม่สามารถใช้ฟิลด์ brightnessRelativeWeight
brightnessRelativeWeight	Number	ซึ่งบ่งบอกถึงปริมาณการเปลี่ยนแปลงความสว่างที่ไม่ชัดเจน จากจำนวนน้อยไปจนถึงจำนวนมาก พารามิเตอร์นี้จะปรับขนาดเป็นจำนวนเต็ม 0 ถึง 5 โดยมีเครื่องหมายเพื่อระบุทิศทาง ไม่บังคับ

ตัวอย่าง

actions:
  type: device.command.BrightnessRelative
  devices: My Device - Room Name
  brightnessRelativePercent: 50