Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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
2500Bardzo ciepła biel
3000Miękki biały, poranny biały, odczyt biały
4000Chłodna biel
5000Światło dzienne, białe
6000Biały kwiatowy
7000Pochmurno, światło dymne
8000Niebieskie zachmurzenie
9000Błę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 urządzenia z tą cechą mogą zawierać podane niżej 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.

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

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

Urządzenie ERRORS

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