Esquema de traço Smart Home HumiditySetting

action.devices.traits.HumiditySetting: esse trait 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 como processar intents SYNC, consulte Fulfillment de intent.

Atributos Tipo Descrição
humiditySetpointRange Object

Contém os níveis mínimo e máximo de umidade como porcentagens.
minPercent Número inteiro

Padrão: 0.

Representa o nível mínimo de umidade como uma porcentagem.

O valor precisa estar entre 0 e 100.
maxPercent Número inteiro

Padrão: 100.

Representa o nível máximo de umidade como uma porcentagem.

O valor precisa estar entre 0 e 100.
commandOnlyHumiditySetting Booleano

Padrão: false.

Indica se o dispositivo é compatível com comunicação unidirecional (true) ou bidirecional (false). Defina esse atributo como "true" se o dispositivo não puder responder a uma intent QUERY ou Report State 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
  }
}

ESTADOS DO DISPOSITIVO

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte Execução 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 da umidade ambiente do dispositivo como uma porcentagem.

O valor precisa estar entre 1 e 100.

Exemplos

Qual é a umidade mostrada no meu dispositivo?

{
  "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 com 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.

Esse comando exige os seguintes atributos: 
{
  "commandOnlyHumiditySetting": true
}

Parâmetros

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

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.

O valor precisa estar entre -100 e 100.

Defina a ponderação da umidade.

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

Obrigatório.

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

O valor precisa estar entre -5 e 5.

Exemplos

Aumente 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 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 do dispositivo

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