Schema delle caratteristiche del controllo della temperatura per la smart home

action.devices.traits.TemperatureControl: caratteristica per i dispositivi (diversi dai termostati) che supportano il controllo della temperatura, all'interno o intorno al dispositivo.

È diverso dal tratto TemperatureSetting, specifico per i controlli in stile termostato. Il trait TemperatureSetting rappresenta la temperatura ambientale (ambiente/esterno) e non deve essere utilizzato per controllare la temperatura di un dispositivo specifico. Per controllare la temperatura di un dispositivo specifico, devi usare il trait TemperatureControl.

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

Obbligatorio.

Intervallo di temperature supportato dal dispositivo.

minThresholdCelsius Number

Obbligatorio.

Temperatura minima per l'intervallo, in gradi Celsius.

maxThresholdCelsius Number

Obbligatorio.

Temperatura massima per l'intervallo, in gradi Celsius.

temperatureStepCelsius Number

Specifica il passo della temperatura relativa. Si tratta dell'intervallo di regolazione minimo supportato dal dispositivo. Se non specificati, 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 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.

queryOnlyTemperatureControl 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 il controllo tra 150 e 500 gradi Fahrenheit, con incrementi di 5 gradi.

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

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
temperatureSetpointCelsius Number

Il set-point attuale della temperatura, 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
}

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

Imposta 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 350 gradi Fahrenheit.

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

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

Valori supportati:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Espressioni di esempio

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.