Smart-Home-Attributschema für Farbeinstellungen

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 Tripel (Rot, Grün, Blau) dar. RGB ist das Standardfarbmodell. Jedes RGB-Triplet kann als Hexadezimalcode dargestellt werden, der den zusammenhängenden Hexadezimalwerten für das Triplet entspricht. „Blau“ ist beispielsweise (0, 0, 255) und #0000FF. Sie können einen beliebigen Wert im RGB-Farbraum verwenden, also RGB(x, y, z), wobei x, y, z innerhalb des zulässigen Bereichs [0, 255] liegen.

HSV stellt Farben als Tripel (Farbton, Sättigung, Wert) dar. Jeder Farbwert in HSV kann in RGB umgewandelt werden und umgekehrt. Der Farbton hat einen Bereich von [0, 360) Grad (ohne 360, da er auf 0 Grad zurückgeht). Sättigung und Farbton werden durch Gleitkommazahlen im Bereich [0,0; 1,0] dargestellt.

Die Farbtemperatur gibt einige Farben als nicht negative Dezimalwerte in Kelvin an. Dieses Attribut beschreibt „weißes“ oder „warmes“ Licht mit Farbnamen wie „kaltes Weiß“ oder „bedecktes Tageslicht“. Intelligente Lampen mit Farbtemperatur haben in der Regel einen Bereich von [2.000, 9.000] Kelvin, was herkömmlichen Lampen mit fester Kelvin-Einstellung entspricht. Die Farbtemperatur ist eine lineare Skala und eine Teilmenge der RGB/HSV-Farbmodelle mit Vollspektrum. In der folgenden Tabelle finden Sie einige Beispieltemperaturen und die entsprechenden Farbnamen.

Temperatur (Kelvin) Farbname
2000Kerzenlicht
2.500Ultra-Warmweiß
3000Soft White, Morning White, Reading White
4000Kühles Weiß
5000Tageslicht, weiß
6000Blütenweiß
7000Bewölkter Tag, Weißer Rauch
8.000Blau bewölkt
9000Blue Sky

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute als Teil des SYNC-Vorgangs melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
commandOnlyColorSetting Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten kann.
Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung für Farbmodelle.
colorModel String

Erforderlich.

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

Unterstützte Werte:

rgb
hsv
1 Objekt

Unterstützung für Farbtemperaturen.
colorTemperatureRange Objekt

Erforderlich.

Unterstützter Farbtemperaturbereich in Kelvin.
temperatureMinK Ganzzahl

Erforderlich.

Minimal unterstützte Farbtemperatur 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 HSV-Spektrumsfarbmodell unterstützt

{
  "colorModel": "hsv"
}

Gerät, das nur die 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

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
color Objekt

Erforderlich.

Die aktuelle Farbeinstellung, die auf dem Gerät verwendet wird.
Enthält einen der folgenden Elemente:
0 Objekt

Unterstützung der Farbtemperatur
temperatureK Ganzzahl

Erforderlich.

Temperaturwert in Kelvin.
1 Objekt

Unterstützung des RGB-Farbspektrums
spectrumRgb Ganzzahl

Erforderlich.

Farbspektrum-RGB-Wert als dezimale Ganzzahl.
2 Objekt

Farbunterstützung für HSV-Spektrum.
spectrumHsv Objekt

Erforderlich.

HSV-Wert des Spektrums.
hue Number

Farbton
saturation Number

Sättigung.

value Number

Wert.

Beispiele

Welche Farbe hat das Licht? (Warmweiß)

{
  "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ät "COMMANDS"

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.ColorAbsolute

Legen Sie den absoluten Farbwert fest.

Parameter

Parameter Typ Beschreibung
color Objekt

Erforderlich.

Zu festzulegende Farbe.
name String

Farbname, der vom Befehl des Nutzers geparst wurde; ist möglicherweise nicht immer verfügbar (z.B. bei Verwendung relativer Befehle).
Enthält einen der folgenden Elemente:
0 Objekt

Unterstützung der Farbtemperatur
temperature Ganzzahl

Erforderlich.

Temperaturwert in Kelvin. Weitere Informationen findest du unter RGB, HSV und Farbtemperatur.
1 Objekt

Unterstützung des RGB-Farbspektrums
spectrumRGB Ganzzahl

Erforderlich.

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

Farbunterstützung für HSV-Spektrum.
spectrumHSV Objekt

Erforderlich.

HSV-Wert des Spektrums. Weitere Informationen findest du unter RGB, HSV und Farbtemperatur.
hue Number

Farbton
saturation Number

Sättigung.

value Number

Wert.

Beispiele

Mach das Licht warmweiß.

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

Mach das Licht magenta.

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

Wähle ein helles Magenta.

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

Die Parameternamen unterscheiden sich geringfügig zwischen Befehls- und Statusparametern. Dadurch werden Konflikte mit den Statusparametern für die verworfenen 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ätefehler

Eine vollständige Liste der Fehler und Ausnahmen