顏色混用指令指令

說明

將顏色設為指定的色調。在關機的裝置上設定顏色時,裝置會開機,而 OnOffState.state 也會隨之變更。同樣地,當亮度設為 0 時,裝置會關閉,而 OnOffState.state 也會隨之變更。

欄位

類型 說明
devices [裝置]

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

必填

color 顏色

要設定的顏色。

必填

name String

從使用者指令解析的顏色名稱,可能無法隨時使用 (也就是使用相對指令時)。

選用

如要使用這個欄位,則不得使用下列所有欄位:溫度光譜 RGB光譜 HSV

temperature ColorTemperature

溫度值 (以克耳文為單位)。

選用

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

值數字範圍取決於每部裝置。

spectrumRGB ColorHex

以小數整數表示的光譜 RGB 值。

選用

如要使用這個欄位,請勿使用下列所有欄位:nametemperaturespectrumHSV

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

spectrumHSV SpectrumHSV

光譜 HSV 值。

選用

如要使用這個欄位,則不得使用下列所有欄位:溫度光譜 RGB名稱

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

hue 數字

色調。

必填

saturation 數字

飽和度。

必填

value 數字

價值」。

必填

範例

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