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

action.devices.traits.HumiditySetting: questa caratteristica appartiene ai dispositivi che supportano le impostazioni dell'umidità, come umidificatori e deumidificatori.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi Tipo Descrizione
humiditySetpointRange Oggetto

Contiene i livelli di umidità minimo e massimo 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 Valore booleano

(Valore predefinito: false)

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

(Valore predefinito: false)

Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se sul dispositivo è possibile eseguire query solo per informazioni sullo stato e se 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
  }
}

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati Tipo Descrizione
humiditySetpointPercent Intero

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

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

Esempi

Quale umidità indica il mio dispositivo?

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

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento 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à 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à ottimale.

Valori supportati:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Regola il livello di umidità rispetto al valore corrente.

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 variazione di umidità ambigua da una quantità ridotta ("poca") a una grande ("molta").

Esempi

Aumenta l'umidità del 10%

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

Abbassa 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 enunciato

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.