Schema des Traits der Smart-Home-Feuchtigkeitseinstellung

action.devices.traits.HumiditySetting: Diese Eigenschaft gehört zu Geräten, die Luftfeuchtigkeitseinstellungen unterstützen, z. B. Befeuchter und Entfeuchter.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. 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)

Gibt die minimale Luftfeuchtigkeit in Prozent an.
maxPercent Ganzzahl

(Standard: 100)

Gibt die maximale Luftfeuchtigkeit in Prozent an.
commandOnlyHumiditySetting Boolesch

(Standard: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder 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 vom Gerät nur Statusinformationen abgefragt und nicht gesteuert werden können.

Beispiele

Gerät, das den standardmäßigen Luftfeuchtigkeitsbereich unterstützt

{}

Gerät, das einen benutzerdefinierten Luftfeuchtigkeitsbereich unterstützt

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

Gerät STATES

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
humiditySetpointPercent Ganzzahl

Gibt die aktuelle Zielfeuchtigkeit des Geräts in Prozent an. Muss innerhalb von humiditySetpointRange liegen.
humidityAmbientPercent Ganzzahl

Zeigt die aktuelle Luftfeuchtigkeit der Umgebung in Prozent an.

Beispiele

Wie hoch ist die Luftfeuchtigkeit auf meinem Gerät?

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

BEFEHLUNGEN auf dem Gerät

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

action.devices.commands.SetHumidity

Legen Sie die Luftfeuchtigkeit auf einen absoluten Wert fest.

Parameter

Parameter Typ Beschreibung
humidity Ganzzahl

Erforderlich.

Sollwert für Luftfeuchtigkeit in %. Muss innerhalb von humiditySetpointRange liegen.

Beispiele

Stell 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

Passt die Luftfeuchtigkeit relativ zum aktuellen Wert an.

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

Parameter

Die Nutzlast enthält eines der folgenden Elemente:

Luftfeuchtigkeit in Prozent festlegen.

Parameter Typ Beschreibung
humidityRelativePercent Ganzzahl

Erforderlich.

Prozentsatz zum Anpassen der Luftfeuchtigkeit.

Luftfeuchtigkeitsgewicht festlegen.

Parameter Typ Beschreibung
humidityRelativeWeight Ganzzahl

Erforderlich.

Gibt die Änderung der zweideutigen Luftfeuchtigkeit von einem kleinen Betrag ("wenig") zu einem großen Betrag ("sehr viel") an.

Beispiele

Erhöhe die Luftfeuchtigkeit um 10 %

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

Senk die Luftfeuchtigkeit stark

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

Beim Anpassen der Luftfeuchtigkeit ist ein Fehler aufgetreten.

Unterstützte Werte:

maxSettingReached
minSettingReached
valueOutOfRange

Beispieläußerungen

de-DE

  • Welche Luftfeuchtigkeit zeigt das Thermostat an?

en-US

  • what is the humidity upstairs

es-ES

  • cuánta humedad hay ahora en la cocina

fr-FR

  • le thermostat donne quel taux d'humidité

hi-IN

  • ह्यूमिडिटी का स्तर किचन के थर्मोस्टैट से कितना है?

it-IT

  • quanta umidità segna il termostato

ja-JP

  • サーモスタット にどれくらいの湿度ってでてる

ko-KR

  • 온도 조절계 에 습도 몇이야?

nl-NL

  • wat is de vochtigheid op de thermostaat

pt-BR

  • Qual é o nível de humidade mostrado no termostato ?
  • diga qual é a umidade relativa do ar mostrada no termostato

sv-SE

  • Vad är det för luftfuktighet i badrummet ?

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.