このページは Cloud Translation API によって翻訳されました。

スマートホーム ColorSetting トレイトのスキーマ

action.devices.traits.ColorSetting - このトレイトは、色や色温度を変更できるスマートライトなどのデバイスに適用されます。

RGB、HSV、色温度

RGB は、色を（赤、緑、青）からなる 3 つの値の組で表します。RGB がデフォルトのカラーモデルです。RGB は、3 つの 16 進値を連結した 16 進コードで表せます。たとえば、「青」は (0, 0, 255) および #0000FF です。RGB 色空間内の任意の値、つまり x, y, z が [0, 255] の範囲内にある RGB(x, y, z) を使用できます。

HSV は、色を（色相、彩度、明度）の 3 つの値の組で表します。HSV のどの色の値も RGB に変換でき、その逆も可能です。色相は、0 度以上、360 度未満の値で表されます（折り返して 0 度になるため、360 度は入りません）。彩度と明度は、0.0 以上、1.0 以下の浮動小数点数で表されます。

色温度は、一部の色を負の 10 進数で表します。この属性は、「白色」や「暖色」など、色名に「クールホワイト」や「曇りの昼光」などを指定します。色温度に対応するスマートライトは通常、温度範囲が [2000, 9000] ケルビンです。これは、固定ケルビンを使用する従来のライトに対応します。色温度は線形目盛で、RGB/HSV フルスペクトルカラーモデルのサブセットです。気温とそれに対応する色名については、以下の表をご覧ください。

温度（ケルビン）	色名
2000	キャンドルライト
2500	ウルトラウォームホワイト
3,000	ソフトホワイト、モーニングホワイト、読書ホワイト
4000	クールホワイト
5000	デイライト、ホワイト
6000	フローラルホワイト
7,000	曇りの日（ライト）、ホワイトスモーク
8000	ブルー曇
9000	ブルースカイ

デバイスの属性

この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテントフルフィルメントをご覧ください。

属性	タイプ	説明
`commandOnlyColorSetting`	ブール値	（デフォルト: `false`）デバイスが一方向（True）または双方向（False）の通信をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。
次の項目が含まれます。
`0`	オブジェクト	色モデルのサポート。
`colorModel`	文字列	必須。デバイスでサポートされているフルスペクトルカラーモデル。サポートされている値: `rgb` `hsv`
`1`	オブジェクト	色温度サポート。
`colorTemperatureRange`	オブジェクト	必須。サポートされている色温度範囲（ケルビン）。
`temperatureMinK`	Integer	必須。サポートされている最小色温度（ケルビン）。
`temperatureMaxK`	Integer	必須。サポートされる最大色温度（ケルビン）。

例

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`	Integer	必須。気温（ケルビン）。
`1`	オブジェクト	カラー RGB スペクトルのサポート。
`spectrumRgb`	Integer	必須。 10 進の整数としての RGB 値スペクトル。
`2`	オブジェクト	カラー HSV スペクトルのサポート。
`spectrumHsv`	オブジェクト	必須。スペクトル HSV 値。
`hue`	Number	Hue
`saturation`	Number	彩度。
`value`	Number	価値。

例

ライトは何色ですか。（ウォームホワイト）

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

ライトは何色ですか。（マゼンタ）

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

ライトは何色ですか。（マゼンタ）

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

注: ColorSetting トレイトに Report State を使用する場合は、RGB 状態を spectrumRGB、HSV 状態を spectrumHsv に指定します。（州名は大文字で表記する必要があります）。

デバイスのコマンド

この特性を持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテントフルフィルメントをご覧ください。

`action.devices.commands.ColorAbsolute`

絶対色の値を設定します。

パラメータ

パラメータ	タイプ	説明
`color`	オブジェクト	必須。設定する色です。
`name`	文字列	ユーザーのコマンドから解析された色名。常に利用できるとは限りません（相対コマンドを使用する場合など）。
次の項目が含まれます。
`0`	オブジェクト	色温度サポート。
`temperature`	Integer	必須。気温（ケルビン）。詳しくは、RGB、HSV、色温度をご覧ください。
`1`	オブジェクト	カラー RGB スペクトルのサポート。
`spectrumRGB`	Integer	必須。 10 進の整数としての RGB 値スペクトル。詳しくは、RGB、HSV、色温度をご覧ください。
`2`	オブジェクト	カラー HSV スペクトルのサポート。
`spectrumHSV`	オブジェクト	必須。スペクトル HSV 値。詳しくは、RGB、HSV、色温度をご覧ください。
`hue`	Number	Hue
`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 トレイトの状態パラメータとの競合を回避できます。

コマンド	State
`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

デバイスエラー

エラーと例外のリストをご覧ください。