Brightness 相對指令

說明

調整裝置相對亮度。如果亮度設為大於 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