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

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
      }
    }
  }
}

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

指令 狀態
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 på 2000 Kelvin
  • tänd blått ljus i köket

裝置錯誤

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