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