Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema trattino Controllo temperatura smart home

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

Questa impostazione è diversa dalla caratteristica TemperatureSetting, specifica per i controlli in stile termostato. Il tratto TemperatureSetting rappresenta la temperatura ambientale (ambient/room) e non deve essere usata per controllare la temperatura di un dispositivo specifico. Per controllare la temperatura di un dispositivo specifico, devi utilizzare la caratteristica TemperatureControl.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
temperatureRange Oggetto

Obbligatorio.

Intervallo di temperatura supportato dal dispositivo.

minThresholdCelsius Number

Obbligatorio.

Temperatura minima dell'intervallo, in gradi Celsius.

maxThresholdCelsius Number

Obbligatorio.

Temperatura massima dell'intervallo, in gradi Celsius.

temperatureStepCelsius Number

Specifica il passaggio della temperatura relativa. Si tratta dell'intervallo minimo di regolazione supportato dal dispositivo. Se non sono specificati, i passaggi relativi vengono calcolati come percentuale di temperatureRange.

temperatureUnitForUX Stringa

Obbligatorio.

Unità di temperatura utilizzata nelle risposte inviate all'utente.

Valori supportati:

C
F
commandOnlyTemperatureControl Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

queryOnlyTemperatureControl Booleano

(Valore predefinito: false)

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

STATEs dispositivo

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

Stati Tipo Descrizione
temperatureSetpointCelsius Number

Il set-point di temperatura attuale, in gradi Celsius. Deve rientrare in temperatureRange. Obbligatorio se il 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 Soddisfazione degli 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 a 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

Esempi di frasi

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 del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.