Schema der Farbeinstellung für Smart Home

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

Mit RGB werden Farben als (Rot, Grün, Blau) Tripel dargestellt. RGB ist das Standardfarbmodell. Jedes RGB-Triplet kann als Hexadezimalcode dargestellt werden, entsprechend den Hexadezimalwerten für das verkettete Triplet. „Blau“ ist beispielsweise (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 Triole (Farbton, Sättigung, Wert) dar. Jeder Farbwert in HSV kann in RGB umgewandelt werden und umgekehrt. Farbton hat einen Bereich von [0, 360) Grad (ausschließlich 360, da er sich auf 0 Grad erstreckt). Sättigung und Wert werden durch Gleitkommazahlen im Bereich [0,0 bis 1,0] dargestellt.

Die Farbtemperatur stellt einige Farben als nicht negative Dezimalwerte in Kelvin dar. Dieses Attribut beschreibt „weiße“ oder „warme“ Lampen mit Farbnamen wie „Kühles Weiß“ oder „Bedecktes Tageslicht“. Intelligente Lampen, die Farbtemperatur unterstützen, haben in der Regel einen Bereich von [2.000, 9.000] Kelvin, was herkömmlichen Lampen mit festem Kelvin entspricht. Die Farbtemperatur ist eine lineare Skala und eine Teilmenge der RGB/HSV-Farbmodelle des vollständigen Spektrums. In der folgenden Tabelle finden Sie einige Beispieltemperaturen und die entsprechenden Farbnamen.

Temperatur (Kelvin) Farbname
2.000Kerzenlicht
2.500Ultra warmes Weiß
3.000Weiches Weiß, Morgenweiß, Leseweiß
4.000Kühles Weiß
5.000Tageslicht, weiß
6.000Blumigweiß
7000Tageslicht, bewölkt, Rauchweiß
8.000Blau bedeckt
9000Blauer Himmel

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
commandOnlyColorSetting Boolesch

(Standard: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann.
Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung von Farbmodellen.
colorModel String

Erforderlich.

Vollspektrum-Farbmodell, das vom Gerät unterstützt wird.

Unterstützte Werte:

rgb
hsv
1 Objekt

Unterstützung für Farbtemperatur.
colorTemperatureRange Objekt

Erforderlich.

Unterstützter Farbtemperaturbereich in Kelvin.
temperatureMinK Ganzzahl

Erforderlich.

Unterstützte Mindestfarbtemperatur in Kelvin.
temperatureMaxK Ganzzahl

Erforderlich.

Maximale unterstützte Farbtemperatur in Kelvin.

Beispiele

Gerät, das sowohl das RGB-Spektrum-Farbmodell als auch die Farbtemperatur unterstützt.

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

Gerät, das nur das Farbmodell des HSV-Spektrums unterstützt.

{
  "colorModel": "hsv"
}

Gerät, das nur die Farbtemperatur unterstützt

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

Gerät, das nur HSV-Farbmodellbefehle unterstützt.

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

Gerät STATES

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY-Vorgangs 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 für Farbtemperatur.
temperatureK Ganzzahl

Erforderlich.

Temperaturwert in Kelvin.
1 Objekt

Unterstützung für Farb-RGB-Spektrum.
spectrumRgb Ganzzahl

Erforderlich.

RGB-Wert des Spektrums als Dezimalzahl.
2 Objekt

Unterstützung des Farb-HSV-Spektrums.
spectrumHsv Objekt

Erforderlich.

HSV-Wert des Spektrums
hue Number

Farbton.
saturation Number

Sättigung.

value Number

Mehrwert.

Beispiele

Welche Farbe hat die Lampe? (Warmweiß)

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

Welche Farbe hat die Lampe? (Magenta)

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

Welche Farbe hat die Lampe? (Magenta)

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

BEFEHLE auf dem Gerät

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs 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

Der vom Nutzerbefehl geparste Farbname. Dieser ist möglicherweise nicht immer verfügbar (z. B. bei Verwendung relativer Befehle).
Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung für Farbtemperatur.
temperature Ganzzahl

Erforderlich.

Temperaturwert in Kelvin. Weitere Informationen finden Sie unter RGB, HSV und Farbtemperatur.
1 Objekt

Unterstützung für Farb-RGB-Spektrum.
spectrumRGB Ganzzahl

Erforderlich.

RGB-Wert des Spektrums als Dezimalzahl. Weitere Informationen finden Sie unter RGB, HSV und Farbtemperatur.
2 Objekt

Unterstützung des Farb-HSV-Spektrums.
spectrumHSV Objekt

Erforderlich.

HSV-Wert des Spektrums Weitere Informationen finden Sie unter RGB, HSV und Farbtemperatur.
hue Number

Farbton.
saturation Number

Sättigung.

value Number

Mehrwert.

Beispiele

Leuchte ein warmes Weiß.

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

Verwende helles Magenta.

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

Verwende helles Magenta.

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

Beachten Sie, dass sich die Parameternamen zwischen Befehls- und Statusparametern leicht unterscheiden. So werden Konflikte mit den Statusparametern für die veralteten Traits ColorSpectrum und ColorTemperature vermieden.

Befehl Status
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

Beispieläußerungen

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

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.