Schemat schematu inteligentnego ustawienia domu domowego
action.devices.traits.ColorSetting
– tę cechę stosuje się na urządzeniach takich jak inteligentne oświetlenie, które mogą zmieniać kolor i temperaturę kolorów.
RGB, HSV i temperatura kolorów
RGB przedstawia kolory w kolorze czerwonym, zielonym i niebieskim. Domyślnym kolorem jest RGB. Każda tryplet RGB może być podana w postaci kodu szesnastkowego zgodnie z wartościami szesnastkowymi dla połączonego sprzężenia. 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 reprezentuje kolory w formie triole (kolor, nasycenie, wartość). Każda wartość koloru w HSV może być przekonwertowana na RGB i odwrotnie. Odcień ma zakres [0, 360) (wyłącznie 360, bo zawija się do 0 stopni). Nasycenie i wartość są podawane za pomocą wartości zmiennoprzecinkowych w zakresie [0,0, 1,0].
Temperatura kolorów reprezentuje niektóre kolory jako wartości dziesiętne nieujemne w kelwinach. Ten atrybut opisuje „białe” lub „ciepłe” światła o kolorach takich jak „chłodny biały” lub „pochmurny dzień”. Inteligentne oświetlenie obsługujące temperaturę barwową ma zazwyczaj zakres [2000, 9000] Kelwina, który odpowiada konwencjonalnym lampom o stałej wartości Kelvina. Temperatura kolorów to liniowa skala i podzbiór modeli kolorów z całego spektrum RGB/HSV. W tabeli poniżej znajdziesz przykładowe temperatury i odpowiadające im nazwy kolorów.
Temperatura (kelwin) | Nazwa koloru |
---|---|
2000 | Świecznik |
2500 | Ultraciepła biel |
3000 | Miękki, poranek i biały |
4000 | Chłodna biel |
5000 | Światło dzienne, białe |
6000 | Biały kwiatowy |
7000 | Pochmurny dzień, biały dym |
8000 | Niebieskie zachmurzenie |
9000 | Błękitne niebo |
ATTRIBUTES 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 (prawda), 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 koloru. |
colorModel |
Ciąg |
Wymagane. Urządzenie obsługuje pełny zakres kolorów. Obsługiwane wartości:
|
1
|
Obiekt |
Obsługa temperatury kolorów. |
colorTemperatureRange |
Obiekt |
Wymagane. Obsługiwany zakres kolorów: Kelwin. |
temperatureMinK |
Liczba całkowita |
Wymagane. Minimalna obsługiwana temperatura w Kelvinach. |
temperatureMaxK |
Liczba całkowita |
Wymagane. Maksymalna obsługiwana temperatura w kelwinach |
Przykłady
Urządzenie, które obsługuje zarówno model kolorów ze spektrum kolorów RGB, jak i temperaturę kolorów.
{ "colorModel": "rgb", "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Urządzenie obsługujące tylko model kolorów widma HSV.
{ "colorModel": "hsv" }
Urządzenie, które obsługuje tylko temperaturę kolorów.
{ "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 9000 } }
Urządzenie obsługujące tylko polecenia modelu koloru HSV.
{ "colorModel": "hsv", "commandOnlyColorSetting": true }
Urządzenie STATES
W ramach operacji QUERY
encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
color |
Obiekt |
Wymagane. Obecne ustawienie kolorów 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ść widma RGB jako liczba dziesiętna. |
2
|
Obiekt |
Obsługa spektrum kolorów HSV. |
spectrumHsv |
Obiekt |
Wymagane. Wartość HSV widma. |
hue |
Number |
Odcień. |
saturation |
Number |
Nasycenie. |
value |
Number |
Wartość. |
Przykłady
Jaki kolor ma światło? (Ciepło białe)
{ "color": { "temperatureK": 3000 } }
Jaki kolor ma światło? (purpurowy)
{ "color": { "spectrumRgb": 16711935 } }
Jaki kolor ma światło? (purpurowy)
{ "color": { "spectrumHsv": { "hue": 300, "saturation": 1, "value": 1 } } }
Urządzenie CommandS
W ramach operacji EXECUTE
urządzenia z tą cechą mogą reagować 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 |
Wymagane. Kolor do ustawienia. |
name |
Ciąg |
Nazwa koloru przeanalizowana za pomocą polecenia użytkownika.Nie zawsze jest ona 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 |
Wymagane. Wartość temperatury w kelwinach. Więcej informacji: RGB, HSV i temperatura kolorów. |
1
|
Obiekt |
Obsługa spektrum kolorów RGB. |
spectrumRGB |
Liczba całkowita |
Wymagane. Wartość widma RGB jako liczba dziesiętna. Więcej informacji: RGB, HSV i temperatura kolorów. |
2
|
Obiekt |
Obsługa spektrum kolorów HSV. |
spectrumHSV |
Obiekt |
Wymagane. Wartość HSV widma. Więcej informacji: RGB, HSV i temperatura kolorów. |
hue |
Number |
Odcień. |
saturation |
Number |
Nasycenie. |
value |
Number |
Wartość. |
Przykłady
Zmień kolor w ciepły na biały.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } }
Zmień kolor na jasnopurpurowy.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumRGB": 16711935 } } }
Zmień kolor na jasnopurpurowy.
{ "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Magenta", "spectrumHSV": { "hue": 300, "saturation": 1, "value": 1 } } } }
Pamiętaj, że nazwy parametrów nieznacznie się różnią między parametrami polecenia i stanu. Pozwala to uniknąć konfliktów 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