BrightnessRelativeCommand

説明

デバイスの相対的な明るさを調整します。明るさが 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