Esquema de traços da 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 informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
humiditySetpointRange Object

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

minPercent Número inteiro

Padrão: 0.

Representa o nível de umidade mínima em porcentagem.

maxPercent Número inteiro

Padrão: 100.

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

commandOnlyHumiditySetting Booleano

Padrão: false.

Indica se o dispositivo oferece suporte ao 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 ao estado do relatório dessa característica.

queryOnlyHumiditySetting Booleano

Padrão: false.

Obrigatório se o dispositivo permitir a execução somente de consulta. Esse atributo indica se o dispositivo só pode ser consultado em busca de 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 intervalos de umidade personalizados.

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
humiditySetpointPercent Número inteiro

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

humidityAmbientPercent Número inteiro

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

Exemplos

Qual é o nível de umidade mostrado 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 o gerenciamento 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 programada. Deve 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.

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 percentual 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 variação ambígua de umidade de pequena ("um pouco") para grande ("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.

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 ?

ERROS DO Dispositivo

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