スマートホーム 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 |
ブール値 |
(デフォルト: デバイスが一方向(True)または双方向(False)の通信をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
次の項目が含まれます。 | ||
0
|
オブジェクト |
色モデルのサポート。 |
colorModel |
文字列 |
必須。 デバイスでサポートされているフルスペクトル カラーモデル。 サポートされている値:
|
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 } } }
デバイスのコマンド
この特性を持つデバイスは、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 aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket