Esquema do traço de umidade de configuração de umidade da casa inteligente

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

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos Tipo Descrição
humiditySetpointRange Object

Contém os níveis mínimo e máximo de umidade em porcentagens.

minPercent Número inteiro

Padrão: 0.

Representa o nível mínimo de umidade como uma 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 de CONSULTA ou ao estado do 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 o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

Estados Tipo Descrição
humiditySetpointPercent Número inteiro

Indica a porcentagem de umidade desejada atual do dispositivo. Precisa estar dentro de humiditySetpointRange.

humidityAmbientPercent Número inteiro

Indica a leitura atual da umidade do ambiente do dispositivo em porcentagem.

Exemplos

Qual é a umidade exibida no meu dispositivo?

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

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

action.devices.commands.SetHumidity

Define 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 programada. Precisa estar dentro de humiditySetpointRange.

Exemplos

Defina a umidade como 20%.

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

Ocorreu um erro ao definir a umidade desejada.

Valores compatíveis:

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.

Definir peso de umidade.

Parâmetros Tipo Descrição
humidityRelativeWeight Número inteiro

Obrigatório.

Indica a quantidade de mudança ambígua de umidade de uma quantidade pequena ("um pouco") para uma grande quantidade ("muito").

Exemplos

Aumentar a umidade em 10%

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

Diminuir bastante a umidade

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

Ocorreu um erro ao ajustar a umidade.

Valores compatíveis:

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 ?

ERROS no dispositivo

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