Esquema del rasgo HumiditySetting de Smart Home

action.devices.traits.HumiditySetting: Este rasgo pertenece a los dispositivos que admiten parámetros de configuración de humedad, como humidificadores y deshumidificadores.

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
humiditySetpointRange Objeto

Contiene los niveles de humedad mínimos y máximos como porcentajes.
minPercent Número entero

(predeterminado: 0)

Representa el nivel de humedad mínimo como un porcentaje.

El valor debe estar entre 0 y 100.
maxPercent Número entero

(predeterminado: 100)

Representa el nivel máximo de humedad como porcentaje.

El valor debe estar entre 0 y 100.
commandOnlyHumiditySetting Booleano

(predeterminado: false)

Indica si el dispositivo admite la comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a una intención de QUERY o Report State para este rasgo.
queryOnlyHumiditySetting Booleano

(predeterminado: false)

Se requiere si el dispositivo admite la ejecución solo de consultas. Este atributo indica si solo se puede consultar el dispositivo para obtener información sobre su estado y si no se puede controlar.

Ejemplos

Un dispositivo que admita el rango de humedad predeterminado

{}

Dispositivo que admite un rango de humedad personalizado.

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

ESTADOS del dispositivo

Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents de QUERY, consulta Entrega de intents.

Estados Tipo Descripción
humiditySetpointPercent Número entero

Indica el porcentaje de humedad objetivo actual del dispositivo. Debe estar dentro de humiditySetpointRange.
humidityAmbientPercent Número entero

Indica la lectura actual de la humedad ambiental del dispositivo como porcentaje.

El valor debe estar entre 1 y 100.

Ejemplos

¿Qué humedad muestra mi dispositivo?

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.SetHumidity

Establece el nivel de humedad en un valor absoluto.

Parámetros

Parámetros Tipo Descripción
humidity Número entero

Obligatorio.

Porcentaje de humedad del punto de ajuste. Debe estar dentro de humiditySetpointRange.

Ejemplos

Establece la humedad en un 20%.

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

Se produjo un error al configurar la humedad objetivo.

Valores admitidos:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Ajusta el nivel de humedad en relación con el valor actual.

Este comando requiere los siguientes atributos: 
{
  "commandOnlyHumiditySetting": true
}

Parámetros

La carga útil contiene uno de los siguientes elementos:

Establece el porcentaje de humedad.

Parámetros Tipo Descripción
humidityRelativePercent Número entero

Obligatorio.

Es el valor porcentual para ajustar el nivel de humedad.

El valor debe estar entre -100 y 100.

Establece el peso de la humedad.

Parámetros Tipo Descripción
humidityRelativeWeight Número entero

Obligatorio.

Indica la cantidad de cambio de humedad ambiguo, desde una cantidad pequeña ("un poco") hasta una cantidad grande ("mucho").

El valor debe estar entre -5 y 5.

Ejemplos

Aumenta la humedad en un 10%

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

Disminuye mucho la humedad

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

Se produjo un error al ajustar la humedad.

Valores admitidos:

maxSettingReached
minSettingReached
valueOutOfRange

Expresiones de muestra

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 ?

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.