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 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 |
---|---|---|
humiditySetpointRange |
Objekt |
Enthält die minimale und maximale Luftfeuchtigkeit in Prozent. |
minPercent |
Ganzzahl |
(Standard: Die Mindestfeuchtigkeit in Prozent. |
maxPercent |
Ganzzahl |
(Standard: Stellt die maximale Luftfeuchtigkeit in Prozent dar. |
commandOnlyHumiditySetting |
Boolesch |
(Standard: 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: 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 |
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 |
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