說明
調整裝置的相對亮度。如果亮度設為大於 0 的值,裝置會開啟電源,且 OnOffState.state 會變更,反映裝置已開啟電源。同樣地,如果亮度設為 0,裝置就會關機,OnOffState.state 也會隨之變更。
欄位
| 金鑰 | 類型 | 說明 | 
|---|---|---|
devices
 | 
[裝置] | 
 支援調整亮度的燈具等裝置。 必填  | 
brightnessRelativePercent
 | 
號碼 | 
 要變更的確切亮度百分比。 選用 如要使用這個欄位,請勿使用下列所有欄位:brightnessRelativeWeight  | 
brightnessRelativeWeight
 | 
號碼 | 
 這表示亮度變化量不明確。從少量到大量,這個參數會縮放為整數 0 到 5,並以正負號表示方向。 選用  | 
範例
actions:
  type: device.command.BrightnessRelative
  devices: My Device - Room Name
  brightnessRelativePercent: 50