BrightnessRelativeCommand

説明

デバイスの相対的な明るさを調整します。明るさが 0 より大きい値に設定されている場合、デバイスがオフであればオンになり、デバイスがオンであることを反映して OnOffState.state が変化します。同様に、明るさが 0 に設定されると、デバイスの電源がオフになり、OnOffState.state がそれに応じて変化します。

フィールド

キー 型 説明
devices [デバイス]

明るさの変更に対応しているデバイス（ライトなど）。

必須
brightnessRelativePercent 数値

変更する明るさの正確な割合。

省略可

このフィールドを使用する場合、次のフィールドは使用できません。brightnessRelativeWeight
brightnessRelativeWeight 数値

これは、明るさの変化のあいまいな量を示します。このパラメータは、金額の大小に応じて 0 ～ 5 の整数にスケーリングされ、方向を示す符号が付きます。

省略可

例

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