Schema del tratto HumiditySetting per la smart home

action.devices.traits.HumiditySetting: questo attributo appartiene ai dispositivi che supportano le impostazioni di umidità, come umidificatori e deumidificatori.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
humiditySetpointRange Oggetto

Contiene i livelli di umidità minima e massima in percentuale.
minPercent Intero

(valore predefinito: 0)

Rappresenta il livello di umidità minimo in percentuale.
maxPercent Intero

(valore predefinito: 100)

Rappresenta il livello di umidità massima in percentuale.
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 intento QUERY o a uno stato Report per questa caratteristica.
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 può essere controllato.

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 scoprire di più sulla gestione degli intent QUERY, consulta Adempimento 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.

Esempi

Quale umidità mostra il mio dispositivo?

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

COMANDI del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento 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 set-point. 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à in base 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à.

Imposta il peso dell'umidità.

Parametri Tipo Descrizione
humidityRelativeWeight Intero

Obbligatorio.

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

Esempi

Aumenta l'umidità del 10%

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

Abbassare notevolmente l'umidità

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

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

Valori supportati:

maxSettingReached
minSettingReached
valueOutOfRange

Frasi di esempio

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.