Schéma du Trait pour le paramètre "HumiditySetting" de la maison connectée

action.devices.traits.HumiditySetting : cette caractéristique 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 cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs Type Description
humiditySetpointRange Objet

Contient les niveaux d'humidité minimum et maximal sous forme de pourcentages.

minPercent Entier

(Par défaut : 0)

Représente le niveau d'humidité minimal sous forme de pourcentage.

maxPercent Entier

(Par défaut : 100)

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

commandOnlyHumiditySetting Valeur booléenne

(Par défaut : false)

Indique si l'appareil prend en charge la communication à sens unique (true) ou à double sens (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou à l'état du rapport pour cette caractéristique.

queryOnlyHumiditySetting Valeur booléenne

(Par défaut : false)

Obligatoire si l'appareil est compatible avec l'exécution par requête uniquement. Cet attribut indique si l'appareil ne peut être interrogé que pour des informations d'état et s'il ne peut pas être contrôlé.

Exemples

Appareil compatible avec la plage d'humidité par défaut.

{}

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

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

STATES de l'appareil

Les entités avec cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États Type Description
humiditySetpointPercent Entier

Indique le pourcentage d'humidité cible actuel de l'appareil. Doit être compris dans la plage humiditySetpointRange.

humidityAmbientPercent Entier

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

Exemples

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

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

COMMANDES DE L'APPAREIL

Les appareils dotés de cette caractéristique 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 la section Traitement des intents.

action.devices.commands.SetHumidity

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

Paramètres

Paramètres Type Description
humidity Entier

Obligatoire.

Pourcentage d'humidité de la température mémorisée. Doit se trouver dans humiditySetpointRange.

Exemples

Règle le taux d'humidité sur 20 %.

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

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

Valeurs acceptées :

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Ajustez le niveau 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 du pourcentage pour ajuster le niveau d'humidité.

Définissez le poids de l'humidité.

Paramètres Type Description
humidityRelativeWeight Entier

Obligatoire.

Indique la variation d'humidité ambiguë, passant d'une faible quantité ("peu") à une forte variation ("beaucoup").

Exemples

Augmente le taux d'humidité de 10 %

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

Réduire considérablement l'humidité

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

Une erreur s'est produite lors de l'ajustement 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 de l'appareil

Consultez la liste complète des erreurs et exceptions.