亮度相对命令

说明

调整设备相对亮度。当亮度设置为大于 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