顏色混用指令指令

說明

將顏色設為指定色調。如果裝置螢幕的顏色處於關閉狀態,裝置會開機,OnOffState.state 則會變更來反映這個顏色。同樣地,當亮度設為 0 時,裝置會關機,OnOffState.state 也會隨之變更。

欄位

金鑰 類型 說明
devices [裝置]

智慧型燈具等裝置,可以改變顏色或色溫。

需要

可使用變數。

color 顏色

要設定的顏色。

需要

name 字串

從使用者指令剖析的顏色名稱;不一定隨時可用 (即使用相對指令)。

選用

如要使用這個欄位,「不得」使用下列所有欄位:temperaturespectrumRGBspectrumHSV

可使用變數。

temperature ColorTemperature

克耳文的溫度值。

選用

如要使用這個欄位,「不得」使用下列所有欄位:namespectrumRGBspectrumHSV

可使用變數。

數值範圍視裝置而定。

spectrumRGB ColorHex

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

選用

如要使用這個欄位,「不得」使用下列所有欄位:nametemperaturespectrumHSV

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

可使用變數。

spectrumHSV SpectrumHSV

Spectrum HSV 值。

選用

如要使用這個欄位,「不得」使用下列所有欄位:temperaturespectrumRGBname

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

hue 數字

色調

需要

可使用變數。

saturation 數字

飽和度。

需要

可使用變數。

value 數字

價值

需要

可使用變數。

範例

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