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