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.

Schema für die Smart-Home-Helligkeit

action.devices.traits.Brightness: In diesem Feld wird beschrieben, wie die Helligkeit eines Geräts gesteuert wird.

Gerät ATTRIBUTE

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

Attribute Typ Beschreibung
commandOnlyBrightness 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.

Beispiele

Gerät, das Helligkeitsbefehle unterstützt, Statusberichte und Berichte erstellt.

{}

Gerät, das nur Helligkeitsbefehle unterstützt.

{
  "commandOnlyBrightness": 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
brightness Ganzzahl

Aktuelle Helligkeitsstufe des Geräts.

Beispiele

Wie hoch ist meine Helligkeit?

{
  "brightness": 65
}

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

Absolute Helligkeit des Geräts anpassen.

Parameter

Parameter Typ Beschreibung
brightness Ganzzahl

Erforderlich.

Neue absolute Helligkeit in Prozent.

Beispiele

Stell die Helligkeit der Lampe auf 65% ein.

{
  "command": "action.devices.commands.BrightnessAbsolute",
  "params": {
    "brightness": 65
  }
}

action.devices.commands.BrightnessRelative

Relative Helligkeit des Geräts anpassen.

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "commandOnlyBrightness": true
}

Parameter

Die Nutzlast enthält einen der folgenden Werte:

Relative relative Gebotsanpassung.

Parameter Typ Beschreibung
brightnessRelativePercent Ganzzahl

Erforderlich.

Der genaue Prozentsatz der Helligkeit, der geändert werden soll.

Relative Gewichtsanpassung.

Parameter Typ Beschreibung
brightnessRelativeWeight Ganzzahl

Erforderlich.

Dies ist der zweideutige Betrag der Helligkeitsänderung. Von kleiner bis großer Menge wird dieser Parameter auf eine Ganzzahl von 0 bis 5 skaliert, wobei das Vorzeichen die Richtung angibt.

Beispiele

Mach meine Lampe um 20 % heller.

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativePercent": 20
  }
}

Dimme das Licht ein wenig.

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativeWeight": -1
  }
}

Beispieläußerungen

de-DE

  • Bitte mach das Licht ein bisschen dunkler
  • Bitte stell das Flurlicht auf ein Drittel
  • Die Küche ein wenig heller stellen
  • Erhöhe die Helligkeit
  • Erhöhe die Helligkeit um 20 %
  • Helligkeit der Leselampe auf 5 %
  • Helligkeit im Wohnzimmer 10 % stellen
  • Mach das Licht bitte 20 % dunkler
  • Mach das Licht bitte 20 % heller
  • Mach das Licht sehr Hölle
  • Mach das Schlafzimmer ein bisschen dunkler
  • Mach das Wohnzimmer dunkler
  • Stell das Licht auf 50 % ein.
  • Stelle das Licht bitte auf maximale Helligkeit
  • Stelle Die Beleuchtung heller
  • Verringere die Helligkeit der Beleuchtung
  • Verringere die Helligkeit in der Küche um 20 %

en-US

  • Aufhellen Hell 10%
  • Helligkeit Beleuchtung 20% erhöhen
  • leicht aufhellen leicht
  • die Küche 50 aufhellen
  • Helligkeit die LEDs erhöhen
  • dimme die Lichter
  • Leuchten Etwas Mehr
  • dimme Lampen von 20%
  • Helligkeit im Wohnzimmer erhöhen 100 %
  • dunkler machen im Wohnzimmer
  • Schlafzimmer heller machen
  • die Lichter etwas heller heller machen
  • das Wohnzimmer ein wenig dimmer
  • Helligkeit des Wohnzimmers um 50% verringern
  • Licht auf Maximum einstellen
  • Helligkeit light Maximum ändern

es-ES

  • pon las luces a la mitad

fr-FR

  • Mets la lumière sur 20 %
  • Salon au Maximum .
  • allume la lampe à 20 % de luminosité
  • allume la lumière du salon au maximal
  • Assombris la Kitchen de 20 %
  • ug l'éclairage de 20 %
  • Augmente l'éclairage de la Cuisine
  • augmente la luminosité de 10 % dans le salon
  • augmente la luminosité de la chambre
  • Augmente un peu l'éclairage
  • Augmente un peu la luminosité de la chambre
  • Bais les lumières
  • baisse les lumières de 20 %
  • baisse un peu la lumière du salon
  • luminosité de la chambre à 20 %
  • moins de luminosité dans le salon

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen