Smart Home HumiditySetting Trait Schema

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

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
humiditySetpointRange Objekt

Enthält die minimalen und maximalen Luftfeuchtigkeitswerte als Prozentsätze.
minPercent Ganzzahl

(Standardeinstellung: 0)

Gibt die Mindestluftfeuchtigkeit als Prozentsatz an.

Wert muss zwischen 0 und 100 liegen
maxPercent Ganzzahl

(Standardeinstellung: 100)

Gibt die maximale Luftfeuchtigkeit als Prozentsatz an.

Wert muss zwischen 0 und 100 liegen
commandOnlyHumiditySetting Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die Einwegkommunikation (true) oder die Zweiwegkommunikation (false) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder einen Report State für dieses Merkmal reagieren kann.
queryOnlyHumiditySetting Boolesch

(Standardeinstellung: false)

Erforderlich, wenn das Gerät die reine Ausführung von Anfragen unterstützt. Dieses Attribut gibt an, ob der Status des Geräts nur abgefragt, aber nicht gesteuert werden kann.

Beispiele

Gerät, das den Standardbereich für die Luftfeuchtigkeit unterstützt

{}

Gerät, das einen benutzerdefinierten Feuchtigkeitsbereich unterstützt

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

Gerätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Bundesstaaten Typ Beschreibung
humiditySetpointPercent Ganzzahl

Gibt den aktuellen Prozentsatz der Zielluftfeuchtigkeit des Geräts an. Muss innerhalb von humiditySetpointRange liegen.
humidityAmbientPercent Ganzzahl

Gibt die aktuelle Luftfeuchtigkeit des Geräts in Prozent an.

Wert muss zwischen 1 und 100 liegen

Beispiele

Welche Luftfeuchtigkeit wird auf meinem Gerät angezeigt?

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

GERÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.SetHumidity

Luftfeuchtigkeit auf einen absoluten Wert einstellen

Parameter

Parameter Typ Beschreibung
humidity Ganzzahl

Erforderlich.

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

Beispiele

Stelle die Luftfeuchtigkeit auf 20 Prozent ein.

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

Beim Einstellen der Zielfeuchtigkeit ist ein Fehler aufgetreten.

Unterstützte Werte:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Passen Sie 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.

Der Prozentwert, um die Luftfeuchtigkeit anzupassen.

Wert muss zwischen -100 und 100 liegen

Gewicht für Luftfeuchtigkeit festlegen.

Parameter Typ Beschreibung
humidityRelativeWeight Ganzzahl

Erforderlich.

Gibt an, wie stark sich die Luftfeuchtigkeit geändert hat, von gering („etwas“) bis stark („viel“).

Wert muss zwischen -5 und 5 liegen

Beispiele

Erhöhe die Luftfeuchtigkeit um 10 Prozent.

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

Luftfeuchtigkeit stark senken

{
  "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ÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen