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