智慧型住宅的色彩設定特徵結構定義

action.devices.traits.ColorSetting - 這項特性適用於可改變顏色或色溫的裝置,例如智慧型燈具。

RGB、HSV 和色溫

RGB 代表以 (紅、綠、藍) 三元表示的顏色。RGB 是預設的色彩模式。任何 RGB 三元組都可以用十六進位碼表示,與串連的三元組的十六進位值相等。例如,「藍色」為 (0, 0, 255) 和 #0000FF。 您可以在 RGB 色域中使用任何值;也就是 RGB(x, y, z),其中 x, y, z 在 [0, 255] (含) 範圍內。

HSV 會以 (色調、飽和度、值) 三元表示顏色。HSV 中的任何顏色值都可以轉換為 RGB,反之亦然。「Hue」的溫度範圍是 [0, 360] 度 (不含 360 度,因為其繞環為 0 度)。飽和度和值會以 [0.0, 1.0] 範圍中的浮點數表示。

顏色溫度會以克爾文中的非負小數值表示「部分」顏色。此屬性用於描述「白色」或「暖色」燈,並加上「冷白色」或「天窗日光」等顏色名稱。支援色溫的智慧型燈具通常為 [2000, 9000] 克耳文,這個範圍與採用固定克耳文固定的傳統燈具相對應。色溫是指線性比例和 RGB/HSV 全色域色彩模型的子集。如需溫度及對應的顏色名稱範例,請參閱下表。

溫度 (克耳文) 顏色名稱
2000燭光
2500超暖白色
3000柔光白、晨光白、閱讀白色
4000冷白光
5000白天、白色
6000花卉白
7000陰晴天,白色煙霧
8000藍色多雲
9000藍天

裝置屬性

具備這個特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱「意圖執行要求」。

屬性 類型 說明
commandOnlyColorSetting 布林

(預設值:false)。

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特性的 QUERY 意圖或報告狀態,請將此屬性設為 true。

包含下列任一項目:
0 物件

支援色彩模型。

colorModel String

必要。

裝置支援的完整光譜顏色模型。

支援的值:

rgb
hsv
1 物件

支援色溫。

colorTemperatureRange 物件

必要。

支援的色溫範圍 (克耳文)。

temperatureMinK 整數

必要。

支援的最低色溫 (克耳文)。

temperatureMaxK 整數

必要。

支援的最高色溫 (克耳文)。

範例

支援 RGB 頻譜和色溫的裝置。

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

裝置僅支援 HSV 光譜色彩模式。

{
  "colorModel": "hsv"
}

裝置僅支援色溫。

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

僅支援 HSV 色彩模型指令的裝置。

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱「意圖執行要求」。

狀態 類型 說明
color 物件

必要。

裝置目前使用的色彩設定。

包含下列其中一個項目:
0 物件

支援色溫。

temperatureK 整數

必要。

溫度值 (克耳文)。

1 物件

支援 RGB 色域。

spectrumRgb 整數

必要。

以十進位整數表示 RGB 值

2 物件

支援色彩 HSV 頻譜。

spectrumHsv 物件

必要。

Spectrum HSV 的值。

hue Number

順心

saturation Number

飽和度。

value Number

價值

範例

燈具的顏色為何?(暖白)

{
  "color": {
    "temperatureK": 3000
  }
}

燈具的顏色為何?(洋紅色)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

燈具的顏色為何?(洋紅色)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

裝置指令

具有這個特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱「意圖執行要求」。

action.devices.commands.ColorAbsolute

設定絕對顏色值。

參數

參數 類型 說明
color 物件

必要。

要設定的顏色。

name String

從使用者指令剖析的顏色名稱,有時可能無法使用 (即使用相對指令時)。

包含下列其中一個項目:
0 物件

支援色溫。

temperature 整數

必要。

溫度值 (克耳文)。詳情請參閱 RGB、HSV 和色溫

1 物件

支援 RGB 色域。

spectrumRGB 整數

必要。

以十進位整數表示 RGB 值詳情請參閱 RGB、HSV 和色溫

2 物件

支援色彩 HSV 頻譜。

spectrumHSV 物件

必要。

Spectrum HSV 的值。詳情請參閱 RGB、HSV 和色溫

hue Number

順心

saturation Number

飽和度。

value Number

價值

範例

將燈光設為溫暖的白色。

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

讓淺洋紅色調。

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

讓淺洋紅色調。

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

請注意,指令和狀態參數的參數名稱稍有不同。這可避免與已淘汰 ColorSpectrumColorTemperature 特徵的狀態參數發生衝突。

指令 狀態
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

語音範例

de-DE

  • Stell die Farbe der Lampe auf blau
  • Stelle die Farbtemperatur auf 3000 Kelvin ein.

en-US

  • can you adjust my lights color to 4000 kelvins
  • set the lights to blue

es-ES

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

fr-FR

  • Allume la lampe de la chambre à 3500 kelvins .
  • mets les lampes en rose dans la chambre

hi-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

it-IT

  • Imposta la lampada a 2000 K .
  • metti la luce gialla

ja-JP

  • 照明 の色を にして
  • 照明 の色温度を 5000K にセットして

ko-KR

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

nl-NL

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

pt-BR

  • Colocar a lâmpada em 2000 K .
  • Define a lâmpada para 2000 K .
  • colocar a luz da sala em azul
  • põe a luz da sala a vermelho

sv-SE

  • Ställ in lampan 2000 Kelvin
  • tänd blått ljus i köket

裝置錯誤

請參閱錯誤和例外狀況的完整清單。