Brightness 相對指令

說明

調整裝置的相對亮度。如果亮度設為大於 0 的值,裝置會開啟電源,且 OnOffState.state 會變更,反映裝置已開啟電源。同樣地,如果亮度設為 0,裝置就會關機,OnOffState.state 也會隨之變更。

欄位

金鑰 類型 說明
devices [裝置]

支援變更亮度的燈具等裝置。

必填

brightnessRelativePercent 號碼

要變更的確切亮度百分比。

選用

如要使用這個欄位,請勿使用下列所有欄位:brightnessRelativeWeight

brightnessRelativeWeight 號碼

這表示亮度變化量不明確。無論金額大小,這個參數都會縮放為 0 到 5 的整數,並以正負號表示方向。

選用

範例

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