Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones de casa inteligente. Nota: Seguirás compilando acciones en la Consola de Actions.

Esquema de la función de control de temperatura del hogar inteligente

action.devices.traits.TemperatureControl: Es la función para dispositivos (que no son termostatos) que admiten el control de temperatura, ya sea dentro o alrededor del dispositivo.

Esto difiere de la característica TemperatureSetting, que es específicamente para controles de estilo de termostato. La característica TemperatureSetting representa la temperatura ambiente (habitación/exterior) y no debe usarse para controlar la temperatura de un dispositivo específico. Para controlar la temperatura de un dispositivo específico, debes usar la característica TemperatureControl.

ATRIBUTOS DEL DISPOSITIVO

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre el manejo de intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
temperatureRange Objeto

Obligatorio.

Rango de temperatura admitido del dispositivo.

minThresholdCelsius Número

Obligatorio.

Temperatura mínima del rango, en grados Celsius.

maxThresholdCelsius Número

Obligatorio.

Temperatura máxima del rango en grados Celsius.

temperatureStepCelsius Número

Especifica el paso de temperatura relativo. Este es el intervalo de ajuste mínimo que admite el dispositivo. Si no se especifica, los pasos relativos se calculan como un porcentaje de temperatureRange.

temperatureUnitForUX String

Obligatorio.

Unidad de temperatura que se usa para responder al usuario.

Valores admitidos:

C
F
commandOnlyTemperatureControl Booleano

(Predeterminado: false)

Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado de informe para esta característica.

queryOnlyTemperatureControl Booleano

(Predeterminado: false)

Obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si el dispositivo solo se puede consultar para obtener información de estado y no se puede controlar.

Ejemplos

Dispositivo que admite un control de entre 150 y 500 grados Fahrenheit, en incrementos de 5 grados

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

Dispositivo STATEs

Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
temperatureSetpointCelsius Número

El punto de ajuste de temperatura actual, en grados Celsius. Debe ser de temperatureRange. Obligatorio si queryOnlyTemperatureControl se estableció como false

temperatureAmbientCelsius Número

La temperatura observada actualmente, en grados Celsius. Debe ser de temperatureRange.

Ejemplos

¿A qué temperatura se estableció el dispositivo?

{
  "temperatureSetpointCelsius": 150
}

Dispositivo COMMANDS

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.SetTemperature

Establece la temperatura en un valor específico.

Parámetros

Parámetros Tipo Descripción
temperature Número

Obligatorio.

La temperatura que se debe establecer, en grados Celsius. Debe ser de temperatureRange.

Ejemplos

Establece el dispositivo en 350 grados Fahrenheit.

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

Se produjo un error cuando se configuraba la temperatura final.

Valores admitidos:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Expresiones de muestra

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.