亮度相对命令

说明

调整设备相对亮度。当亮度设置为大于 0 的任何值时,如果设备处于关闭状态,则会开机,并且 OnOffState.state 会发生变化,以反映设备处于开机状态。同样,当亮度设置为 0 时,设备会关机,并且 OnOffState.state 也会相应发生变化。

字段

类型 说明
devices [Device]

支持更改亮度的设备,例如灯。

必需

brightnessRelativePercent 数字

要更改的亮度的确切百分比。

可选

如需使用此字段,则不得使用以下所有字段:brightnessRelativeWeight

brightnessRelativeWeight 数字

此字段表示亮度变化的不明确量。从少量到大量,此参数将缩放为整数 0 到 5,并使用符号表示方向。

可选

示例

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