Schéma du trait "HumiditySetting" pour la maison connectée

action.devices.traits.HumiditySetting : ce trait appartient aux appareils compatibles avec les paramètres d'humidité, tels que les humidificateurs et les déshumidificateurs.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

Attributs Type Description
humiditySetpointRange Objet

Contient les niveaux d'humidité minimal et maximal sous forme de pourcentages.
minPercent Entier

(Par défaut : 0)

Représente le niveau d'humidité minimal en pourcentage.

La valeur doit être comprise entre 0 et 100.
maxPercent Entier

(Par défaut : 100)

Représente le niveau d'humidité maximal en pourcentage.

La valeur doit être comprise entre 0 et 100.
commandOnlyHumiditySetting Valeur booléenne

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à une intention QUERY ni à un rapport d'état pour cette caractéristique.
queryOnlyHumiditySetting Valeur booléenne

(Par défaut : false)

Obligatoire si l'appareil est compatible avec l'exécution en mode requête uniquement. Cet attribut indique si l'état de l'appareil peut uniquement être interrogé et non contrôlé.

Exemples

Un appareil compatible avec la plage d'humidité par défaut.

{}

Appareil compatible avec une plage d'humidité personnalisée.

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

États Type Description
humiditySetpointPercent Entier

Indique le pourcentage d'humidité cible actuel de l'appareil. La valeur doit être comprise dans humiditySetpointRange.
humidityAmbientPercent Entier

Indique le niveau d'humidité ambiante actuel de l'appareil en pourcentage.

La valeur doit être comprise entre 1 et 100.

Exemples

Quel taux d'humidité mon appareil affiche-t-il ?

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

COMMANDES de l'appareil

Les appareils dotés de ce trait peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Fulfillment d'intent.

action.devices.commands.SetHumidity

Définissez le taux d'humidité sur une valeur absolue.

Paramètres

Paramètres Type Description
humidity Entier

Obligatoire.

Pourcentage d'humidité cible. La valeur doit être comprise dans humiditySetpointRange.

Exemples

Règle l'humidité sur 20 %.

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

Une erreur s'est produite lors de la définition de l'humidité cible.

Valeurs acceptées :

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Ajustez le taux d'humidité par rapport à la valeur actuelle.

Cette commande nécessite les attributs suivants : 
{
  "commandOnlyHumiditySetting": true
}

Paramètres

La charge utile contient l'un des éléments suivants :

Régler le pourcentage d'humidité

Paramètres Type Description
humidityRelativePercent Entier

Obligatoire.

Valeur en pourcentage permettant d'ajuster le taux d'humidité.

La valeur doit être comprise entre -100 et 100.

Définissez le poids de l'humidité.

Paramètres Type Description
humidityRelativeWeight Entier

Obligatoire.

Indique l'ampleur de la variation ambiguë de l'humidité, d'une petite quantité ("un peu") à une grande quantité ("beaucoup").

La valeur doit être comprise entre -5 et 5.

Exemples

Augmente l'humidité de 10 %

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

Diminue beaucoup l'humidité

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

Une erreur s'est produite lors du réglage de l'humidité.

Valeurs acceptées :

maxSettingReached
minSettingReached
valueOutOfRange

Exemples d'énoncés

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 ?

ERREURS liées à l'appareil

Consultez la liste complète des erreurs et exceptions.