Schema dei tratti per l'impostazione dell'umidità per la smart home

action.devices.traits.HumiditySetting. Questa caratteristica appartiene ai dispositivi che supportano le impostazioni relative all'umidità, come umidificatori e deumidificatori.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi	Tipo	Descrizione
humiditySetpointRange	Oggetto	Contiene il livello minimo e massimo di umidità in percentuale.
minPercent	Intero	(Valore predefinito: 0) Rappresenta il livello minimo di umidità in percentuale.
maxPercent	Intero	(Valore predefinito: 100) Rappresenta il livello massimo di umidità in percentuale.
commandOnlyHumiditySetting	Booleano	(Valore predefinito: false) Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait.
queryOnlyHumiditySetting	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 se 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
  }
}

Dispositivo STATES

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

Stati	Tipo	Descrizione
humiditySetpointPercent	Intero	Indica la percentuale di umidità target corrente del dispositivo. Deve rientrare in humiditySetpointRange.
humidityAmbientPercent	Intero	Indica la lettura attuale dell'umidità ambientale del dispositivo in percentuale.

Esempi

Quale umidità viene visualizzata sul mio dispositivo?

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

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.SetHumidity

Imposta il livello di umidità su un valore assoluto.

Parametri

Parametri	Tipo	Descrizione
humidity	Intero	Obbligatorio. Percentuale di umidità set-point. Deve rientrare in humiditySetpointRange.

Esempi

Imposta l'umidità su 20%.

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

Errori correlati

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

Valori supportati:

maxSettingReached

minSettingReached

valueOutOfRange

action.devices.commands.HumidityRelative

Regola il livello di umidità in base al valore corrente.

Questo comando richiede i seguenti attributi:

{
  "commandOnlyHumiditySetting": true
}

Parametri

Il payload contiene uno dei seguenti valori:

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 piccola quantità ("poco") a una grande quantità ("molto").

Esempi

Aumenta l'umidità del 10%

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

Abbassa notevolmente l'umidità

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

Errori correlati

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

Valori supportati:

maxSettingReached

minSettingReached

valueOutOfRange

Espressioni 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 ?

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.