Smart-Home-Trait-Schema für Farbeinstellungen

action.devices.traits.ColorSetting : Dieses Trait gilt für Geräte wie smarte Lampen, die ihre Farbe oder Farbtemperatur ändern können.

RGB, HSV und Farbtemperatur

RGB stellt Farben als (Rot, Grün, Blau)-Triplett dar. RGB ist das Standardfarbmodell. Jedes RGB-Triplett kann als Hexadezimalcode dargestellt werden, der den verketteten Hexadezimalwerten für das Triplett entspricht. Beispiel: „Blau“ ist (0, 0, 255) und #0000FF. Sie können einen beliebigen Wert im RGB-Farbraum verwenden, d. h. RGB(x, y, z), wobei x, y und z im Bereich [0, 255] liegen .

HSV stellt Farben als (Farbton, Sättigung, Wert)-Triplett dar. Jeder Farbwert in HSV kann in RGB konvertiert werden und umgekehrt. Der Farbton hat einen Bereich von [0, 360) Grad (360 Grad sind ausgeschlossen, da er auf 0 Grad zurückgesetzt wird). Sättigung und Wert werden durch Gleitkommazahlen im Bereich [0,0, 1,0] dargestellt.

Die Farbtemperatur stellt einige Farben als nicht negative Dezimalwerte in Kelvin dar. Dieses Attribut beschreibt "weiße" oder "warme" Lichter mit Farbnamen wie "Tageslichtweiß" oder "Bewölkter Tag". Smarte Lampen, die die Farbtemperatur unterstützen, haben in der Regel einen Bereich von [2000, 9000] Kelvin, was herkömmlichen Lampen mit fester Kelvin-Zahl entspricht. Die Farbtemperatur ist eine lineare Skala und eine Teilmenge der RGB/HSV-Vollspektrum-Farbmodelle. In der folgenden Tabelle finden Sie einige Beispieltemperaturen und die entsprechenden Farbnamen.

Geräteattribute

Geräte mit diesem Trait können die folgenden Attribute im Rahmen des SYNC Vorgangs melden. Weitere Informationen zur Verarbeitung von SYNC Intents finden Sie unter Intent-Erfüllung.

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-Spektrum-Farbmodell 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ätestatus

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY Vorgangs melden. Weitere Informationen zur Verarbeitung von QUERY Intents finden Sie unter Intent-Erfüllung.

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ätebefehle

Geräte mit diesem Trait können im Rahmen des EXECUTE Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zur Verarbeitung von EXECUTE Intents finden Sie unter Intent-Erfüllung.

action.devices.commands.ColorAbsolute

Legt den absoluten Farbwert fest.

Parameter

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
    }
  }
}

Mach das Licht magenta.

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

Die Parameternamen unterscheiden sich leicht zwischen Befehls- und Statusparametern. Dadurch werden Konflikte mit den Statusparametern für die veralteten ColorSpectrum und ColorTemperature Traits vermieden.

Beispieläußerungen

Gerätefehler