Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la función Control de temperatura de la casa inteligente

action.devices.traits.TemperatureControl: Características para los dispositivos (distintos de los termostatos) que admiten el control de la temperatura, ya sea dentro o alrededor del dispositivo.

Se diferencia de la característica TemperatureSetting, que es específicamente para los controles de estilo termostato. La característica TemperatureSetting representa la temperatura del ambiente (la habitación o el 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 cómo manejar los 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 para el rango, en grados Celsius.

temperatureStepCelsius Número

Especifica el paso de temperatura relativa. 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 en las respuestas para el 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 del informe para esta característica.

queryOnlyTemperatureControl Booleano

(Predeterminado: false)

Obligatorio si el dispositivo solo admite la ejecución de consultas. 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 controles 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

Los dispositivos con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo manejar los 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 se configura queryOnlyTemperatureControl como false

temperatureAmbientCelsius Número

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

Ejemplos

¿En qué temperatura se estableció el dispositivo?

{
  "temperatureSetpointCelsius": 150
}

Dispositivo COMMAND

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 cómo manejar los 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 la temperatura del dispositivo en 350 grados Fahrenheit.

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

Se produjo un error al establecer 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

en-US

  • I want the temperature of the oven higher
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno

fr-FR

  • 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
  • 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

pt-BR

  • 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

  • höj temperaturen i ugnen
  • sätt ugnen 100 grader

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.