Ta strona została przetłumaczona przez Cloud Translation API.

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: `false`) 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: `rgb` `hsv`
`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
    }
  }
}

Uwaga: jeśli korzystasz ze stanu raportu na potrzeby cechy ColorSetting, pamiętaj, aby określić stan RGB jako spectrumRGB, a stan HSV – spectrumHsv. (W przypadku nazw stanów należy użyć dokładnie takiej samej wielkości liter).

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

Urządzenie ERRORS

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