Schema del tratto TemperatureControl per la smart home

action.devices.traits.TemperatureControl - Opzione per dispositivi (diversi dai termostati) che supportano il controllo della temperatura all'interno o nelle vicinanze del dispositivo.

Questo è diverso dall'attributo TemperatureSetting, che è specifico per i controlli in stile termostato. Il tratto TemperatureSetting rappresenta la temperatura ambiente (stanza/esterno) e non deve essere utilizzato per controllare la temperatura di un dispositivo specifico. Per controllare la temperatura di un dispositivo specifico, devi utilizzare il tratto TemperatureControl.

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
temperatureRange Oggetto

Obbligatorio.

Intervallo di temperatura supportato del dispositivo.

minThresholdCelsius Number

Obbligatorio.

Temperatura minima dell'intervallo, in gradi Celsius.

maxThresholdCelsius Number

Obbligatorio.

Temperatura massima per l'intervallo, in gradi Celsius.

temperatureStepCelsius Number

Specifica il passo di temperatura relativo. Si tratta dell'intervallo di regolazione minimo supportato dal dispositivo. Se non specificato, i passaggi relativi vengono calcolati come percentuale di temperatureRange.

temperatureUnitForUX String

Obbligatorio.

Unità di temperatura utilizzata nelle risposte all'utente.

Valori supportati:

C
F
commandOnlyTemperatureControl Valore booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'utilizzo della 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.

queryOnlyTemperatureControl 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 il controllo tra 65 e 260 gradi Celsius, con incrementi di 5 gradi.

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

STATI del dispositivo

Le entità con questo attributo 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
temperatureSetpointCelsius Number

Il set-point temperatura attuale, in gradi Celsius. Deve rientrare in temperatureRange. Obbligatorio se queryOnlyTemperatureControl è impostato su false

temperatureAmbientCelsius Number

La temperatura attualmente osservata, in gradi Celsius. Deve rientrare in temperatureRange.

Esempi

A quale temperatura è impostato il dispositivo?

{
  "temperatureSetpointCelsius": 150
}

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.SetTemperature

Impostare la temperatura su un valore specifico.

Parametri

Parametri Tipo Descrizione
temperature Number

Obbligatorio.

La temperatura da impostare, in gradi Celsius. Deve rientrare in temperatureRange.

Esempi

Imposta il dispositivo su 177 gradi Celsius.

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

Si è verificato un errore durante l'impostazione della temperatura ottimale.

Valori supportati:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Esempi di enunciato

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Temperatur des Ofens auf 425 Grad
  • Wie warm ist der Ofen

en-US

  • I want the temperature of the oven higher
  • current temperature in the fridge
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno
  • ¿A qué temperatura está el horno ?

fr-FR

  • Le four est à quelle température ?
  • Mets la température du four à 180 degrés .
  • augmente la température du four

hi-IN

  • ओवन का टेम्परेचर कितना है
  • ओवन का तापमान 425 डिग्री पर करें

it-IT

  • Alza la temperatura del forno
  • Qual è la temperatura del frigo ?
  • metti il forno a 200 gradi

ja-JP

  • オーブン の温度は何度
  • オーブン の温度を 425度 に設定して
  • オーブン の温度を上げて

ko-KR

  • 오븐 온도 180 도로 맞춰
  • 오븐 온도 몇 도야
  • 오븐 온도 좀 높여 줄래

nl-NL

  • stel de oven in op 220 graden
  • verhoog de temperatuur van de oven
  • wat is de temperatuur van de oven

pt-BR

  • Diz-me qual é a temperatura da sala
  • Qual é a temperatura do forno ?
  • ajuste a temperatura do forno para 180 graus
  • aumenta a temperatura do forno
  • aumentar a temperatura do forno
  • define a temperatura do termostato nos 22 graus

sv-SE

  • Vad är det för temperatur i ugnen ?
  • höj temperaturen i ugnen
  • sätt ugnen 100 grader

ERRORI dispositivo

Consulta l'elenco completo di errori ed eccezioni.