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 der Luftfeuchtigkeitseinstellung für Smart Home

action.devices.traits.HumiditySetting: Dieses Attribut gehört zu Geräten, die Feuchtigkeitseinstellungen wie Befeuchter und Entfeuchter unterstützen.

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

Enthält die minimale und maximale Luftfeuchtigkeit in Prozent.

minPercent Ganzzahl

(Standard: 0)

Die Mindestfeuchtigkeit in Prozent.

maxPercent Ganzzahl

(Standard: 100)

Stellt die maximale Luftfeuchtigkeit in Prozent dar.

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

queryOnlyHumiditySetting Boolesch

(Standard: false)

Erforderlich, wenn das Gerät die Ausführung nur für Abfragen unterstützt. Dieses Attribut gibt an, ob das Gerät nur für Statusinformationen abgefragt werden kann und nicht gesteuert werden kann.

Beispiele

Gerät, das die Standardfeuchtigkeit unterstützt

{}

Gerät, das eine benutzerdefinierte Luftfeuchtigkeit unterstützt.

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

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

Zeigt die aktuelle Luftfeuchtigkeit in Prozent des Geräts an. Muss innerhalb von humiditySetpointRange liegen.

humidityAmbientPercent Ganzzahl

Gibt die aktuelle Luftfeuchtigkeit des Geräts als Prozentsatz an.

Beispiele

Welche Luftfeuchtigkeit wird auf meinem Gerät angezeigt?

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

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

Stelle die Luftfeuchtigkeit auf einen absoluten Wert ein.

Parameter

Parameter Typ Beschreibung
humidity Ganzzahl

Erforderlich.

Sollwert der Luftfeuchtigkeit in Prozent. Muss innerhalb von humiditySetpointRange liegen.

Beispiele

Stelle die Luftfeuchtigkeit auf 20 % ein.

{
  "command": "action.devices.commands.SetHumidity",
  "params": {
    "humidity": 20
  }
}

Beim Festlegen der Zielfeuchtigkeit ist ein Fehler aufgetreten.

Unterstützte Werte:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Du kannst die Luftfeuchtigkeit im Verhältnis zum aktuellen Wert einstellen.

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

Parameter

Die Nutzlast enthält einen der folgenden Werte:

Luftfeuchtigkeit in Prozent festlegen.

Parameter Typ Beschreibung
humidityRelativePercent Ganzzahl

Erforderlich.

Der Prozentwert, um die Luftfeuchtigkeit anzupassen.

Luftfeuchtigkeit einstellen.

Parameter Typ Beschreibung
humidityRelativeWeight Ganzzahl

Erforderlich.

Gibt die Mehrdeutigkeit der zweideutigen Änderung der Luftfeuchtigkeit von „geringfügig“ an „erheblich“ an.

Beispiele

Luftfeuchtigkeit um 10 % erhöhen

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativePercent": 10
  }
}

Die Luftfeuchtigkeit stark verringern

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativeWeight": -5
  }
}

Beim Anpassen der Luftfeuchtigkeit ist ein Fehler aufgetreten.

Unterstützte Werte:

maxSettingReached
minSettingReached
valueOutOfRange

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen