Schema del tratto HumiditySetting della smart home

action.devices.traits.HumiditySetting - Questo tratto appartiene ai dispositivi che supportano le impostazioni dell'umidità, come umidificatori e deumidificatori.

ATTRIBUTI del dispositivo

I dispositivi con questo tratto possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli intent.

Attributi Tipo Descrizione
humiditySetpointRange Oggetto

Contiene i livelli di umidità minimi e massimi in percentuale.
minPercent Intero

(Valore predefinito: 0)

Rappresenta il livello di umidità minimo in percentuale.

Il valore deve essere compreso tra 0 e 100.
maxPercent Intero

(Valore predefinito: 100)

Rappresenta il livello di umidità massimo in percentuale.

Il valore deve essere compreso tra 0 e 100.
commandOnlyHumiditySetting Valore booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Report State per questo tratto.
queryOnlyHumiditySetting Valore booleano

(Valore predefinito: false)

Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e non è possibile controllarlo.

Esempi

Dispositivo che supporta l'intervallo di umidità predefinito.

{}

Dispositivo che supporta un intervallo di umidità personalizzato.

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Stati Tipo Descrizione
humiditySetpointPercent Intero

Indica la percentuale di umidità target corrente del dispositivo. Deve rientrare in humiditySetpointRange.
humidityAmbientPercent Intero

Indica la lettura dell'umidità ambientale corrente del dispositivo in percentuale.

Il valore deve essere compreso tra 1 e 100.

Esempi

Quale umidità mostra il mio dispositivo?

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

COMANDI del dispositivo

I dispositivi con questo tratto possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.SetHumidity

Imposta il livello di umidità su un valore assoluto.

Parametri

Parametri Tipo Descrizione
humidity Intero

Obbligatorio.

Percentuale di umidità del setpoint. Deve rientrare in humiditySetpointRange.

Esempi

Imposta l'umidità al 20%.

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

Si è verificato un errore durante l'impostazione dell'umidità target.

Valori supportati:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Regola il livello di umidità rispetto al valore attuale.

Questo comando richiede i seguenti attributi: 
{
  "commandOnlyHumiditySetting": true
}

Parametri

Il payload contiene uno dei seguenti elementi:

Imposta la percentuale di umidità.

Parametri Tipo Descrizione
humidityRelativePercent Intero

Obbligatorio.

Il valore percentuale per regolare il livello di umidità.

Il valore deve essere compreso tra -100 e 100.

Imposta il peso dell'umidità.

Parametri Tipo Descrizione
humidityRelativeWeight Intero

Obbligatorio.

Indica la quantità di variazione di umidità ambigua da una piccola quantità ("un po'") a una grande quantità ("molto").

Il valore deve essere compreso tra -5 e 5.

Esempi

Aumenta l'umidità del 10%

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

Riduci molto l'umidità

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

Si è verificato un errore durante la regolazione dell'umidità.

Valori supportati:

maxSettingReached
minSettingReached
valueOutOfRange

Esempi di espressioni

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 ?

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.