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