顏色混用指令指令

說明

將顏色設為指定色調。如果裝置處於關機狀態，設定顏色後裝置會開機，且 OnOffState.state 會隨之變更。同樣地，如果亮度設為 0，裝置就會關機，OnOffState.state 也會隨之變更。

欄位

鍵 類型 說明
devices [裝置]

可變更顏色或色溫的裝置，例如智慧型燈具。

必填
color Color

要設定的顏色。

必填
name String

根據使用者指令剖析出的顏色名稱；使用相對指令時，不一定可以使用。

選用

如要使用這個欄位，請勿使用下列所有欄位：temperature、spectrumRGB、spectrumHSV
temperature ColorTemperature

色溫值 (克耳文)。

選用

如要使用這個欄位，請勿使用下列所有欄位：name、spectrumRGB、spectrumHSV

值的範圍取決於各裝置。
spectrumRGB ColorHex

以十進位整數表示的 Spectrum RGB 值。

選用

如要使用這個欄位，請勿使用下列所有欄位：name、temperature、spectrumHSV

部分裝置可能不支援這個欄位。
spectrumHSV SpectrumHSV

Spectrum HSV 值。

選用

如要使用這個欄位，請勿使用下列所有欄位：temperature、spectrumRGB、name

部分裝置可能不支援這個欄位。
hue Number

色調。

必填
saturation Number

飽和度。

必填
value Number

數值。

必填

範例

actions:
- type: device.command.ColorAbsolute
  devices: My Device - Room Name
  color:
    name: blue