คำอธิบาย
ปรับความสว่างสัมพัทธ์ของอุปกรณ์ เมื่อตั้งค่าความสว่างเป็นค่าใดก็ตามที่มากกว่า 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