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