Schemat atrybutu ColorSetting w inteligentnym domu

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

RGB, HSV i temperatura kolorów

RGB to kod kolorów składowych (czerwony, zielony, niebieski). RGB jest domyślnym modelem kolorów. Każda potrójka RGB może być reprezentowana jako kod szesnastkowy, który jest równoważny wartościom szesnastkowym potrójki połączonej. Na przykład kolor „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 znajdują się w zakresie [0, 255] włącznie.

HSV reprezentuje kolory jako potrój (odczyt, nasycenie, wartość). Każda wartość koloru w HSV może zostać przekonwertowana na RGB i odwrotnie. Odcień ma zakres od 0 do 360 stopni (oprócz wartości 360°, ponieważ obejmuje 0 stopni). Nasycenie i wartość są reprezentowane przez liczby zmiennoprzecinkowe w zakresie [0,0, 1,0].

Temperatura barwowa reprezentuje niektóre kolory jako nieujemne wartości dziesiętne w kelwinach. Ten atrybut opisuje „białe” lub „ciepłe” światła z nazwami kolorów, takimi jak „zimna biała” lub „pochmurny dzień”. Inteligentne światła obsługujące temperaturę barwową zwykle mają zakres [2000, 9000] kelwinów, który odpowiada konwencjonalnym światłom o stałym kelwinach. Temperatura barwy to skala liniowa i podzbiór pełnego spektrum kolorów modeli RGB/HSV. Przykładowe temperatury i odpowiadające im nazwy kolorów znajdziesz w tabeli poniżej.

Temperatura (w kelwinach) Nazwa koloru
2000Światło świec
2500Ultraciepła biel
3000Soft White, Morning White, Reading White
4000Zimna biel
5000Światło dzienne, biały
6000Biały kwiatowy
7000Pochmurny dzień, biały dym
8000Niebieski zachmurzone niebo
9000Błękitne niebo

ATRYBUTY URZĄDZENIA

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

Atrybuty Typ Opis
commandOnlyColorSetting Wartość logiczna

(wartość domyślna: false)

Określa, czy urządzenie obsługuje komunikację w jednym kierunku (prawda) czy w obu kierunkach (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani nie może zgłaszać stanu dla tej cechy.
Zawiera którykolwiek z tych elementów:
0 Obiekt

Obsługa modelu kolorów.
colorModel String

Wymagany.

Model kolorów o pełnym zakresie obsługiwany przez urządzenie.

Obsługiwane wartości:

rgb
hsv
1 Obiekt

Obsługa temperatury kolorów.
colorTemperatureRange Obiekt.

Wymagany.

Obsługiwany zakres temperatury barwowej w kelwinach.
temperatureMinK Liczba całkowita

Wymagany.

Minimalna obsługiwana temperatura barwowa w kelwinach.
temperatureMaxK Liczba całkowita

Wymagane.

Maksymalna obsługiwana temperatura barwowa w kelwinach.

Przykłady

Urządzenie obsługujące zarówno model kolorów w zakresie RGB, jak i temperaturę kolorów.

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

Urządzenie obsługujące tylko model kolorów HSV.

{
  "colorModel": "hsv"
}

Urządzenie obsługujące tylko temperaturę kolorów.

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

Urządzenie obsługujące tylko polecenia modelu kolorów HSV.

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

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
color Obiekt

Wymagany.

Bieżące ustawienie koloru używane na urządzeniu.
Zawiera jeden z tych elementów:
0 Obiekt

Obsługa temperatury kolorów.
temperatureK Liczba całkowita

Wymagane.

Wartość temperatury w kelwinach.
1 Obiekt

Obsługa spektrum kolorów RGB.
spectrumRgb Liczba całkowita

Wymagane.

Wartość RGB widma jako liczba całkowita dziesiętna.
2 Obiekt

Obsługa spektrum kolorów HSV.
spectrumHsv Obiekt

Wymagany.

Wartość HSV widma.
hue Number

Odcień.
saturation Number

Nasycenie.
value Number

Wartość.

Przykłady

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

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

Jaki jest kolor światła? (magenta)

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

Jaki jest kolor światła? (purpurowy)

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

Polecenia na urządzeniu

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 o realizacji intencji.

action.devices.commands.ColorAbsolute

Określ bezwzględną wartość koloru.

Parametry

Parametry Typ Opis
color Obiekt

Wymagane.

Kolor do ustawienia.
name String

Nazwa koloru wyodrębniona z polecenia użytkownika.Może być niedostępna (np. podczas korzystania z poleceń względnych).
Zawiera jeden z tych elementów:
0 Obiekt

Obsługa temperatury kolorów.
temperature Liczba całkowita

Wymagane.

Wartość temperatury w kelwinach. Więcej informacji znajdziesz w artykule RGB, HSV i temperatura barw.
1 Obiekt

Obsługa spektrum kolorów RGB.
spectrumRGB Liczba całkowita

Wymagane.

Wartość RGB widma jako liczba całkowita dziesiętna. Więcej informacji znajdziesz w artykule RGB, HSV i temperatura barw.
2 Obiekt.

Obsługa spektrum kolorów HSV.
spectrumHSV Obiekt

Wymagany.

Wartość HSV widma. Więcej informacji znajdziesz w artykule RGB, HSV i temperatura barw.
hue Number

Odcień.
saturation Number

Nasycenie.
value Number

Wartość.

Przykłady

Ustaw światło na ciepłą biel.

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

Ustaw światło na magenta.

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

Ustaw światło na magenta.

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

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

Polecenie Stan
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

Przykładowe wypowiedzi

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

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.