Schemat schematu inteligentnego ustawienia inteligentnego domu
action.devices.traits.ColorSetting
– ten atrybut dotyczy urządzeń, takich jak inteligentne oświetlenie, które mogą zmieniać kolor i temperaturę kolorów.
RGB, HSV i temperatura kolorów
RGB pokazuje kolory w postaci czerwonego, zielonego i niebieskiego koloru. RGB jest domyślnym modelem kolorów. Każdy triol RGB może być reprezentowany jako szesnastkowy odpowiednik odpowiadającej wartości szesnastkowej połączonej trypla. Na przykład „niebieski” to (0, 0, 255) i #0000FF. W przestrzeni kolorów RGB możesz użyć dowolnej wartości, tj. RGB(x, y, z), gdzie x, y, z są w zakresie [0, 255] włącznie.
HSV oznacza kolory jako triole (kolor, nasycenie i wartość). Wszelkie wartości kolorów w HSV mogą być konwertowane do RGB i odwrotnie. Odcień ma zakres [0, 360] stopni (nie obejmuje 360 stopni, ponieważ mieści się w zakresie 0 stopni). Nasycenie i wartość są reprezentowane przez liczby zmiennoprzecinkowe z zakresu [0,0, 1,0].
Temperatura kolorów oznacza niektóre kolory jako wartości nieujemne dziesiętne w kelwinach. Ten atrybut opisuje światło białe lub „ciepłe” z kolorami takimi jak „zimnobiały” lub „pochmurny dzień”. Inteligentne oświetlenie obsługujące temperaturę kolorów ma zazwyczaj zakres [2000, 9000] Kelwin, co odpowiada konwencjonalnym lampom o stałej wartości Kelvina. Temperatura kolorów to skala liniowa i podzbiór modeli pełnych kolorów RGB/HSV. W tabeli poniżej znajdziesz przykładowe temperatury i odpowiadające im nazwy kolorów.
Temperatura (kelwin) | Nazwa koloru |
---|---|
2000 | Świeczka |
2500 | Bardzo ciepła biel |
3000 | Miękki biały, poranny biały, odczyt biały |
4000 | Chłodna biel |
5000 | Światło dzienne, białe |
6000 | Biały kwiatowy |
7000 | Pochmurno, światło dymne |
8000 | Niebieskie zachmurzenie |
9000 | Błękitne niebo |
ATRYBUTY urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
commandOnlyColorSetting |
Wartość logiczna |
(domyślnie: Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu. |
Zawiera dowolne z tych elementów: | ||
0
|
Obiekt |
Obsługa modelu kolorów. |
colorModel |
Ciąg |
Wymagany. Urządzenie obsługuje pełny model koloru o pełnym spektrum. Obsługiwane wartości:
|
1
|
Obiekt |
Obsługa temperatury kolorów. |
colorTemperatureRange |
Obiekt |
Wymagany. Obsługiwany zakres temperatury barw w kelwinach. |
temperatureMinK |
Liczba całkowita |
Wymagany. Minimalna obsługiwana temperatura barw w kelwinach. |
temperatureMaxK |
Liczba całkowita |
Wymagany. Maksymalna obsługiwana temperatura kolorów w kelwinach. |
Przykłady
Urządzenie, które obsługuje zarówno model kolorów, jak i zakres kolorów RGB.
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Urządzenie, które obsługuje tylko model kolorów spektrum HSV.
{ "colorModel": "hsv" }
Urządzenie, które obsługuje tylko temperaturę kolorów.
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Urządzenie, które obsługuje tylko polecenia modelu kolorów HSV.
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
Urządzenie STATES
W ramach operacji QUERY
encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
color |
Obiekt |
Wymagany. Bieżące ustawienie koloru, które jest obecnie używane na urządzeniu. |
Zawiera jeden z tych elementów: | ||
0
|
Obiekt |
Obsługa temperatury kolorów. |
temperatureK |
Liczba całkowita |
Wymagany. Wartość temperatury w Kelwinach. |
1
|
Obiekt |
Obsługa spektrum kolorów RGB. |
spectrumRgb |
Liczba całkowita |
Wymagany. Wartość spektrum RGB jako liczba dziesiętna. |
2
|
Obiekt |
Obsługa spektrum kolorów HSV. |
spectrumHsv |
Obiekt |
Wymagany. Wartość HSV Spectrum. |
hue |
Number |
Odcień. |
saturation |
Number |
Nasycenie. |
value |
Number |
Wartość. |
Przykłady
Jaki jest kolor oświetlenia? (Ciepło białe)
{ "color": { "temperatureK": 3000 } }
Jaki jest kolor oświetlenia? (amarantowy)
{ "color": { "spectrumRgb": 16711935 } }
Jaki jest kolor oświetlenia? (amarantowy)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.ColorAbsolute
Ustaw bezwzględną wartość koloru.
Parametry
Parametry | Typ | Opis |
---|---|---|
color |
Obiekt |
Wymagany. Kolor do ustawienia. |
name |
Ciąg |
Nazwa koloru analizowana z polecenia użytkownika może nie być dostępna (np. podczas używania poleceń względnych). |
Zawiera jeden z tych elementów: | ||
0
|
Obiekt |
Obsługa temperatury kolorów. |
temperature |
Liczba całkowita |
Wymagany. Wartość temperatury w Kelwinach. Szczegółowe informacje znajdziesz w artykule RGB, HSV i temperatura kolorów. |
1
|
Obiekt |
Obsługa spektrum kolorów RGB. |
spectrumRGB |
Liczba całkowita |
Wymagany. Wartość spektrum RGB jako liczba dziesiętna. Szczegółowe informacje znajdziesz w artykule RGB, HSV i temperatura kolorów. |
2
|
Obiekt |
Obsługa spektrum kolorów HSV. |
spectrumHSV |
Obiekt |
Wymagany. Wartość HSV Spectrum. Szczegółowe informacje znajdziesz w artykule RGB, HSV i temperatura kolorów. |
hue |
Number |
Odcień. |
saturation |
Number |
Nasycenie. |
value |
Number |
Wartość. |
Przykłady
Ustaw ciepłą białą barwę.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
jasnopurpurowy.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
jasnopurpurowy.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Nazwy parametrów różnią się nieco między parametrami polecenia i stanu. Pozwoli to uniknąć konfliktów z parametrami stanu wycofanymi cech ColorSpectrum i ColorTemperature.
Polecenie | Stan |
---|---|
temperature |
temperatureK |
spectrumRGB |
spectrumRgb |
spectrumHSV |
spectrumHsv |
Przykładowe wypowiedzi
de-DE
-
Stell die Farbe
der Lampe aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket