Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

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
2500Ultraciepła biel
3000Miękki, poranek i biały
4000Chłodna biel
5000Światło dzienne, białe
6000Biały kwiatowy
7000Pochmurny dzień, biały dym
8000Niebieskie zachmurzenie
9000Błę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: false)

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:

rgb
hsv
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 2000 Kelvin
  • tänd blått ljus i köket

Urządzenie ERRORS

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