Esquema de características da umidade da casa inteligente

action.devices.traits.HumiditySetting: essa característica pertence a dispositivos compatíveis com as configurações de umidade, como umidificadores e desumidificadores.

ATRIBUTOS DO DISPOSITIVO

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

Atributos	Tipo	Descrição
humiditySetpointRange	Object	Contém os níveis de umidade mínima e máxima em 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 máximo de umidade como uma 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 consultas. 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

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

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

Exemplos

Qual umidade meu dispositivo mostra?

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

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.SetHumidity

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

Parâmetros

Parâmetros	Tipo	Descrição
humidity	Número inteiro	Obrigatório. Porcentagem de umidade definida. Precisa ser dentro de 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 da porcentagem para ajustar o nível de umidade.

Defina o 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 ("um pouco") para uma grande quantidade ("muito").

Exemplos

Aumentar a umidade em 10%

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

Reduza 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.