Description
Sets the color to the specified hue. When the color is set on a device that is off, the device powers on, and the OnOffState.state
changes to reflect this. Likewise, when brightness is set to 0, the device powers off and the OnOffState.state
changes accordingly.
Fields
Key | Type | Description |
---|---|---|
devices
|
[Device] |
Devices such as smart lights that can change color or color temperature. Required |
color
|
Color |
Color to set. Required |
name
|
String |
Color name parsed from the user's command; may not always be available (in other words, when using relative commands). Optional To use this field, all the following fields CANNOT be used: temperature, spectrumRGB, spectrumHSV |
temperature
|
ColorTemperature |
Temperature value in Kelvin. Optional To use this field, all the following fields CANNOT be used: name, spectrumRGB, spectrumHSV The value number range depends on each device. |
spectrumRGB
|
ColorHex |
Spectrum RGB value as a decimal integer. Optional To use this field, all the following fields CANNOT be used: name, temperature, spectrumHSV Some devices may not support this field. |
spectrumHSV
|
SpectrumHSV |
Spectrum HSV value. Optional To use this field, all the following fields CANNOT be used: temperature, spectrumRGB, name Some devices may not support this field. |
hue
|
Number |
Hue. Required |
saturation
|
Number |
Saturation. Required |
value
|
Number |
Value. Required |
Examples
actions:
- type: device.command.ColorAbsolute
devices: My Device - Room Name
color:
name: blue