Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Farbschema der Smart-Home-Farbeinstellung

action.devices.traits.ColorSetting – Diese Eigenschaft gilt für Geräte wie intelligente Lampen, die die Farbe oder Farbtemperatur ändern können.

RGB, HSV und Farbtemperatur

RGB stellt Farben als rotes, grünes, blaues Triolen dar. RGB ist das Standardfarbmodell. Jedes RGB-Triple kann als Hexadezimalcode dargestellt werden, was den Hexadezimalwerten des verketteten Triolen entspricht. Beispiel: „blau“ ist (0, 0, 255) und #0000FF. Sie können einen beliebigen Wert innerhalb des RGB-Farbraums verwenden, d. h. RGB(x, y, z), wobei x, y, z innerhalb des Bereichs [0, 255] (einschließlich) liegen.

HSV stellt Farben als Farbton (Tönung, Sättigung, Wert) für das Drilling dar. Jeder Farbwert in HSV kann in RGB umgewandelt werden und umgekehrt. Hue hat einen Bereich von [0, 360] Grad (exklusive 360 Grad, weil der Wert umgerechnet etwa 0 Grad ist). Sättigung und Wert werden durch Gleitkommazahlen im Bereich [0.0, 1.0] dargestellt.

Farbtemperatur stellt einige Farben als nicht negative Dezimalwerte in Kelvin dar. Dieses Attribut beschreibt „weißes“ oder „warmes“ Licht mit Farbnamen wie „Kühles Weiß“ oder „Bedecktes Tageslicht“. Intelligente Lampen, die die Farbtemperatur unterstützen, haben in der Regel eine Strecke von [2000, 9000] Kelvin, die den konventionellen Lichtern mit festem Kelvin entspricht. Die Farbtemperatur ist eine lineare Skala und ein Teil der RGB-/HSV-Farbspektrumsmodelle. In der folgenden Tabelle finden Sie einige Beispieltemperaturen und die entsprechenden Farbnamen.

Temperatur (Kelvin) Farbname
2.000Kerzenlicht
2.500Ultrawarmes Weiß
3.000Soft White, Morning White, Reading White
4.000Kühles Weiß
5000Tageslicht, weiß
6.000Blütenweiß
7000Tageslicht, bewölkt, weiß
8.000Bedeckt in Blau
9000Blauer Himmel

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
commandOnlyColorSetting Boolesch

(Standard: false)

Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

Enthält die folgenden Elemente:
0 Objekt

Unterstützung von Farbmodellen.

colorModel String

Erforderlich.

Farbmodell des gesamten Spektrums, das vom Gerät unterstützt wird.

Unterstützte Werte:

rgb
hsv
1 Objekt

Unterstützung von Farbtemperaturen

colorTemperatureRange Objekt

Erforderlich.

Unterstützter Farbtemperaturbereich in Kelvin

temperatureMinK Ganzzahl

Erforderlich.

Minimale unterstützte Farbtemperatur in Kelvin

temperatureMaxK Ganzzahl

Erforderlich.

Maximal unterstützte Farbtemperatur in Kelvin

Beispiele

Gerät, das sowohl das RGB-Farbmodell als auch die Farbtemperatur unterstützt

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Gerät, das nur das HSV-Spektrum-Farbmodell unterstützt.

{
  "colorModel": "hsv"
}

Gerät, das nur Farbtemperatur unterstützt.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Gerät, das nur Befehle für das HSV-Farbmodell unterstützt

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
color Objekt

Erforderlich.

Die aktuell auf dem Gerät verwendete Farbeinstellung.

Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung von Farbtemperaturen

temperatureK Ganzzahl

Erforderlich.

Temperaturwert in Kelvin

1 Objekt

Farb-RGB-Spektrumsunterstützung.

spectrumRgb Ganzzahl

Erforderlich.

Spektrum-RGB-Wert als dezimale Ganzzahl.

2 Objekt

Unterstützung von Farb-HSV-Spektrums.

spectrumHsv Objekt

Erforderlich.

Spektrum-HSV-Wert.

hue Number

Hue.

saturation Number

Sättigung.

value Number

Wert.

Beispiele

Welche Farbe hat das Licht? (Wärme weiß)

{
  "color": {
    "temperatureK": 3000
  }
}

Welche Farbe hat das Licht? (Magenta)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

Welche Farbe hat das Licht? (Magenta)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.ColorAbsolute

Legen Sie den absoluten Farbwert fest.

Parameter

Parameter Typ Beschreibung
color Objekt

Erforderlich.

Festzulegende Farbe.

name String

Aus dem Befehl des Nutzers geparster Farbname; ist möglicherweise nicht immer verfügbar (z.B. bei der Verwendung von relativen Befehlen).

Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung von Farbtemperaturen

temperature Ganzzahl

Erforderlich.

Temperaturwert in Kelvin

1 Objekt

Farb-RGB-Spektrumsunterstützung.

spectrumRGB Ganzzahl

Erforderlich.

Spektrum-RGB-Wert als dezimale Ganzzahl.

2 Objekt

Unterstützung von Farb-HSV-Spektrums.

spectrumHSV Objekt

Erforderlich.

Spektrum-HSV-Wert.

hue Number

Hue.

saturation Number

Sättigung.

value Number

Wert.

Beispiele

Mach das Licht warmweiß.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

Macht das Licht in Magenta.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

Macht das Licht in Magenta.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

Beachten Sie, dass sich Parameternamen geringfügig zwischen Befehls- und Statusparametern unterscheiden. Dadurch werden Konflikte mit den Zustandsparametern für die verworfenen Attribute ColorSpectrum und ColorTemperature vermieden.

Befehl Status
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

Beispieläußerungen

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen