Farbschema der Smart-Home-Farbeinstellung
action.devices.traits.ColorSetting
– Diese Eigenschaft gilt für Geräte wie intelligente Lampen, die die Farbe oder Farbtemperatur ändern können.
RGB, HSV und Farbtemperatur
RGB stellt Farben als rotes, grünes, blaues Triolen dar. RGB ist das Standardfarbmodell. Jedes RGB-Triple kann als Hexadezimalcode dargestellt werden, was den Hexadezimalwerten des verketteten Triolen entspricht. Beispiel: „blau“ ist (0, 0, 255) und #0000FF. Sie können einen beliebigen Wert innerhalb des RGB-Farbraums verwenden, d. h. RGB(x, y, z), wobei x, y, z innerhalb des Bereichs [0, 255] (einschließlich) liegen.
HSV stellt Farben als Farbton (Tönung, Sättigung, Wert) für das Drilling dar. Jeder Farbwert in HSV kann in RGB umgewandelt werden und umgekehrt. Hue hat einen Bereich von [0, 360] Grad (exklusive 360 Grad, weil der Wert umgerechnet etwa 0 Grad ist). Sättigung und Wert werden durch Gleitkommazahlen im Bereich [0.0, 1.0] dargestellt.
Farbtemperatur stellt einige Farben als nicht negative Dezimalwerte in Kelvin dar. Dieses Attribut beschreibt „weißes“ oder „warmes“ Licht mit Farbnamen wie „Kühles Weiß“ oder „Bedecktes Tageslicht“. Intelligente Lampen, die die Farbtemperatur unterstützen, haben in der Regel eine Strecke von [2000, 9000] Kelvin, die den konventionellen Lichtern mit festem Kelvin entspricht. Die Farbtemperatur ist eine lineare Skala und ein Teil der RGB-/HSV-Farbspektrumsmodelle. In der folgenden Tabelle finden Sie einige Beispieltemperaturen und die entsprechenden Farbnamen.
Temperatur (Kelvin) | Farbname |
---|---|
2.000 | Kerzenlicht |
2.500 | Ultrawarmes Weiß |
3.000 | Soft White, Morning White, Reading White |
4.000 | Kühles Weiß |
5000 | Tageslicht, weiß |
6.000 | Blütenweiß |
7000 | Tageslicht, bewölkt, weiß |
8.000 | Bedeckt in Blau |
9000 | Blauer Himmel |
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
commandOnlyColorSetting |
Boolesch |
(Standard: Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann. |
Enthält die folgenden Elemente: | ||
0
|
Objekt |
Unterstützung von Farbmodellen. |
colorModel |
String |
Erforderlich. Farbmodell des gesamten Spektrums, das vom Gerät unterstützt wird. Unterstützte Werte:
|
1
|
Objekt |
Unterstützung von Farbtemperaturen |
colorTemperatureRange |
Objekt |
Erforderlich. Unterstützter Farbtemperaturbereich in Kelvin |
temperatureMinK |
Ganzzahl |
Erforderlich. Minimale unterstützte Farbtemperatur in Kelvin |
temperatureMaxK |
Ganzzahl |
Erforderlich. Maximal unterstützte Farbtemperatur in Kelvin |
Beispiele
Gerät, das sowohl das RGB-Farbmodell als auch die Farbtemperatur unterstützt
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Gerät, das nur das HSV-Spektrum-Farbmodell unterstützt.
{ "colorModel": "hsv" }
Gerät, das nur Farbtemperatur unterstützt.
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Gerät, das nur Befehle für das HSV-Farbmodell unterstützt
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
Gerät STATES
Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY
die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
color |
Objekt |
Erforderlich. Die aktuell auf dem Gerät verwendete Farbeinstellung. |
Enthält eines der folgenden Elemente: | ||
0
|
Objekt |
Unterstützung von Farbtemperaturen |
temperatureK |
Ganzzahl |
Erforderlich. Temperaturwert in Kelvin |
1
|
Objekt |
Farb-RGB-Spektrumsunterstützung. |
spectrumRgb |
Ganzzahl |
Erforderlich. Spektrum-RGB-Wert als dezimale Ganzzahl. |
2
|
Objekt |
Unterstützung von Farb-HSV-Spektrums. |
spectrumHsv |
Objekt |
Erforderlich. Spektrum-HSV-Wert. |
hue |
Number |
Hue. |
saturation |
Number |
Sättigung. |
value |
Number |
Wert. |
Beispiele
Welche Farbe hat das Licht? (Wärme weiß)
{ "color": { "temperatureK": 3000 } }
Welche Farbe hat das Licht? (Magenta)
{ "color": { "spectrumRgb": 16711935 } }
Welche Farbe hat das Licht? (Magenta)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Gerätebefehle
Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.ColorAbsolute
Legen Sie den absoluten Farbwert fest.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
color |
Objekt |
Erforderlich. Festzulegende Farbe. |
name |
String |
Aus dem Befehl des Nutzers geparster Farbname; ist möglicherweise nicht immer verfügbar (z.B. bei der Verwendung von relativen Befehlen). |
Enthält eines der folgenden Elemente: | ||
0
|
Objekt |
Unterstützung von Farbtemperaturen |
temperature |
Ganzzahl |
Erforderlich. Temperaturwert in Kelvin |
1
|
Objekt |
Farb-RGB-Spektrumsunterstützung. |
spectrumRGB |
Ganzzahl |
Erforderlich. Spektrum-RGB-Wert als dezimale Ganzzahl. |
2
|
Objekt |
Unterstützung von Farb-HSV-Spektrums. |
spectrumHSV |
Objekt |
Erforderlich. Spektrum-HSV-Wert. |
hue |
Number |
Hue. |
saturation |
Number |
Sättigung. |
value |
Number |
Wert. |
Beispiele
Mach das Licht warmweiß.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
Macht das Licht in Magenta.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
Macht das Licht in Magenta.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Beachten Sie, dass sich Parameternamen geringfügig zwischen Befehls- und Statusparametern unterscheiden. Dadurch werden Konflikte mit den Zustandsparametern für die verworfenen Attribute ColorSpectrum und ColorTemperature vermieden.
Befehl | Status |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
Beispieläußerungen
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