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í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 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 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
  }
}

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 desejada 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 como processar 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 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 aceitos:

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 um dos seguintes:

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 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 aceitos:

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

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