Esquema de atributo HumiditySetting da casa inteligente

action.devices.traits.HumiditySetting: essa característica pertence a dispositivos que oferecem suporte a 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 o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
humiditySetpointRange Object

Contém os níveis mínimos e máximos de umidade como 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 oferece suporte a comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent de QUERY ou ao estado de relatório dessa característica.
queryOnlyHumiditySetting Booleano

Padrão: false.

Obrigatório se o dispositivo oferece suporte à 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
  }
}

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
humiditySetpointPercent Número inteiro

Indica a porcentagem de umidade de destino atual do dispositivo. Precisa estar dentro de humiditySetpointRange.
humidityAmbientPercent Número inteiro

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

Exemplos

Qual umidade meu dispositivo mostra?

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

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

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

Exemplos

Defina a umidade para 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.

Este comando requer os seguintes atributos: 
{
  "commandOnlyHumiditySetting": true
}

Parâmetros

O payload contém uma das seguintes opções:

Definir a 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 mudança de umidade ambígua 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
  }
}

Diminuir muito 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 do dispositivo

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