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