Schemat cechy Smart Home ColorSetting

action.devices.traits.ColorSetting – ta cecha dotyczy urządzeń, takich jak inteligentne oświetlenie, które mogą zmieniać kolor lub temperaturę kolorów.

RGB, HSV i temperatura kolorów

RGB to reprezentacja kolorów w postaci trójki (czerwony, zielony, niebieski). RGB to domyślny model kolorów. Każdy triplet RGB można przedstawić jako kod szesnastkowy, który jest równoważny połączonym wartościom szesnastkowym dla tego tripletu. Na przykład „niebieski” to (0, 0, 255) i #0000FF. Możesz użyć dowolnej wartości w przestrzeni kolorów RGB, czyli RGB(x, y, z), gdzie x, y, z mieszczą się w zakresie [0, 255] włącznie.

HSV reprezentuje kolory jako trójkę (odcień, nasycenie, wartość). Każdą wartość koloru w przestrzeni HSV można przekonwertować na RGB i odwrotnie. Odcień ma zakres [0, 360) stopni (z wyłączeniem 360, ponieważ zawija się do 0 stopni). Nasycenie i wartość są reprezentowane przez liczby zmiennoprzecinkowe z zakresu [0,0, 1,0].

Temperatura kolorów reprezentuje niektóre kolory jako nieujemne wartości dziesiętne w kelwinach. Ten atrybut opisuje światła „białe” lub „ciepłe” z nazwami kolorów, takimi jak „zimna biel” lub „pochmurne światło dzienne”. Inteligentne oświetlenie obsługujące temperaturę barwową ma zwykle zakres [2000, 9000] K, co odpowiada tradycyjnym lampom o stałej temperaturze barwowej. Temperatura barwowa to skala liniowa i podzbiór modeli kolorów RGB/HSV. W tabeli poniżej znajdziesz przykładowe temperatury i odpowiadające im nazwy kolorów.

ATRYBUTY urządzenia

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Przykłady

Urządzenie obsługujące model kolorów RGB i temperaturę barwową.

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

Urządzenie, które obsługuje tylko model kolorów HSV.

{
  "colorModel": "hsv"
}

Urządzenie, które obsługuje tylko temperaturę barwową.

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

Urządzenie, które obsługuje tylko polecenia modelu kolorów HSV.

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

Stany urządzenia

Podmioty z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Przykłady

Jaki jest kolor światła? (ciepła biel)

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

Jaki jest kolor światła? (amarantowy)

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

Jaki jest kolor światła? (amarantowy)

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

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.ColorAbsolute

Ustaw bezwzględną wartość koloru.

Parametry

Przykłady

Ustaw ciepłą białą barwę światła.

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

Ustaw jasnopurpurowe światło.

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

Ustaw światło na kolor purpurowy.

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

Pamiętaj, że nazwy parametrów poleceń i stanów nieco się różnią. Pozwala to uniknąć kolizji z parametrami stanu wycofanych cech ColorSpectrum i ColorTemperature.

Przykładowe wypowiedzi

BŁĘDY urządzenia