亮度相对命令

说明

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

字段

键 类型 说明
devices [设备]

支持调节亮度的设备,例如灯。

必填

brightnessRelativePercent 数字

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

可选

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

brightnessRelativeWeight 数字

这表示亮度变化的模糊量。此参数将按从小到大的顺序缩放为 0 到 5 之间的整数,并带有表示方向的符号。

可选

示例

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