Schéma de trait HumiditySetting pour 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 en 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 à un état de 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 obtenir des informations sur son état et ne peut pas être 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 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 humiditySetpointRange.
humidityAmbientPercent Entier

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

Exemples

Quel est le taux d'humidité affiché par mon appareil ?

{
  "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é cible. Doit être compris 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 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 l'ampleur de la variation ambiguë de l'humidité, de faible (un peu) à importante (beaucoup).

Exemples

Augmenter l'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.