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
  }
}

Ähnliche Fehler

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
  }
}

Ähnliche Fehler

Beim Anpassen der Luftfeuchtigkeit ist ein Fehler aufgetreten.

Unterstützte Werte:

maxSettingReached

minSettingReached

valueOutOfRange

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen