Esquema de características de umidade da casa inteligente

action.devices.traits.HumiditySetting: esta característica pertence a dispositivos compatíveis com umidade, como umidificadores e desumidificadores.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de intent.

Atributos	Tipo	Descrição
humiditySetpointRange	Object	Contém os níveis de umidade mínima e máxima como porcentagens.
minPercent	Número inteiro	Padrão: 0. Representa o nível mínimo de umidade em porcentagem.
maxPercent	Número inteiro	Padrão: 100. Representa o nível de umidade máxima como porcentagem.
commandOnlyHumiditySetting	Booleano	Padrão: false. Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para essa característica.
queryOnlyHumiditySetting	Booleano	Padrão: false. Obrigatório se o dispositivo for compatível com a execução somente de consulta. Esse atributo indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado.

Exemplos

Dispositivo compatível com o intervalo de umidade padrão.

{}

Dispositivo compatível com um intervalo de umidade personalizado.

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

STATES do dispositivo

As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte fulfillment de intent.

Estados	Tipo	Descrição
humiditySetpointPercent	Número inteiro	Indica a porcentagem de umidade desejada do dispositivo. Precisa estar em humiditySetpointRange.
humidityAmbientPercent	Número inteiro	Indica a leitura de umidade ambiente atual do dispositivo como uma porcentagem.

Exemplos

Qual umidade é exibida no meu dispositivo?

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

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.SetHumidity

Defina o nível de umidade para um valor absoluto.

Parâmetros

Parâmetros	Tipo	Descrição
humidity	Número inteiro	Obrigatório. Porcentagem de umidade definida. Precisa estar em humiditySetpointRange.

Exemplos

Defina a umidade para 20%.

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

Erros relacionados

Ocorreu um erro ao definir a umidade desejada.

Os valores suportados são:

maxSettingReached

minSettingReached

valueOutOfRange

action.devices.commands.HumidityRelative

Ajuste o nível de umidade em relação ao valor atual.

Esse comando requer os seguintes atributos:

{
  "commandOnlyHumiditySetting": true
}

Parâmetros

O payload contém um dos seguintes itens:

Definir porcentagem de umidade.

Parâmetros	Tipo	Descrição
humidityRelativePercent	Número inteiro	Obrigatório. O valor percentual para ajustar o nível de umidade.

Definir peso da umidade.

Parâmetros	Tipo	Descrição
humidityRelativeWeight	Número inteiro	Obrigatório. Indica a quantidade de umidade ambígua alterada de uma pequena quantidade ("pequena") para uma quantidade grande ("muito").

Exemplos

Aumentar a umidade em 10%

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

Diminuir muito a umidade

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

Erros relacionados

Ocorreu um erro ao ajustar a umidade.

Os valores suportados são:

maxSettingReached

minSettingReached

valueOutOfRange

Exemplos de declarações

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 ?

Dispositivo ERRORS

Veja a lista completa de erros e exceções.