Esquema de atributos HumiditySetting de la casa inteligente

action.devices.traits.HumiditySetting: Este atributo pertenece a dispositivos que admiten la configuración de humedad, como humidificadores y deshumidificadores.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar 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 mínimo de humedad como un porcentaje.
maxPercent Número entero

(Predeterminado: 100)

Representa el nivel máximo de humedad como un porcentaje.
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 un intent de QUERY o a un estado de informe para esta función.
queryOnlyHumiditySetting Booleano

(Predeterminado: false)

Obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si solo se puede consultar información de estado del dispositivo y no se puede controlar.

Ejemplos

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 atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar 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 un porcentaje.

Ejemplos

¿Qué humedad muestra mi dispositivo?

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

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar 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 cuando se configuraba la humedad objetivo.

Valores admitidos:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Ajusta el nivel de humedad en función del valor actual.

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

Parámetros

La carga útil contiene una de las siguientes opciones:

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.

Establece el peso de la humedad.

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

Obligatorio.

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

Ejemplos

Aumentar la humedad un 10%

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

Disminuir mucho la humedad

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

Se produjo un error cuando se ajustaba 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.