Esquema do traço Temperatura Control de casa inteligente

action.devices.traits.TemperatureControl: característica para dispositivos (exceto termostatos) compatíveis com controle de temperatura, dentro ou ao redor do dispositivo.

Isso é diferente da característica TemperatureSetting, especificamente para controles de termostato. O atributo TemperatureSetting representa a temperatura ambiente (ambiente/externo) e não deve ser usada para controlar a temperatura de um dispositivo específico. Para controlar a temperatura de um dispositivo específico, é necessário usar a característica TemperatureControl.

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos Tipo Descrição
temperatureRange Object

Obrigatório.

Faixa de temperatura compatível com o dispositivo.
minThresholdCelsius Número

Obrigatório.

É a temperatura mínima do intervalo, em graus Celsius.
maxThresholdCelsius Número

Obrigatório.

Temperatura máxima do intervalo, em graus Celsius.
temperatureStepCelsius Número

Especifica a etapa de temperatura relativa. Esse é o intervalo mínimo de ajuste aceito pelo dispositivo. Se não for especificada, as etapas relativas serão calculadas como uma porcentagem de temperatureRange.
temperatureUnitForUX String

Obrigatório.

Unidade de temperatura usada nas respostas ao usuário.

Valores compatíveis:

C
F
commandOnlyTemperatureControl Booleano

Padrão: false.

Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent de CONSULTA ou ao estado do relatório para essa característica.
queryOnlyTemperatureControl Booleano

Padrão: false.

Obrigatório se o dispositivo for compatível com a execução somente de consultas. Esse atributo indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado.

Exemplos

Controle de suporte do dispositivo entre 50 e 500 graus Fahrenheit, em incrementos de 5 graus.

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

STATES do dispositivo

Entidades com essa característica podem relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

Estados Tipo Descrição
temperatureSetpointCelsius Número

A temperatura programada atual, em graus Celsius. Precisa estar dentro de temperatureRange. Obrigatório se queryOnlyTemperatureControl for definido como false
temperatureAmbientCelsius Número

A temperatura observada atualmente, em graus Celsius. Precisa estar dentro de temperatureRange.

Exemplos

Qual é a temperatura definida no dispositivo?

{
  "temperatureSetpointCelsius": 150
}

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

action.devices.commands.SetTemperature

Definir a temperatura com um valor específico.

Parâmetros

Parâmetros Tipo Descrição
temperature Número

Obrigatório.

A temperatura a ser definida, em graus Celsius. Precisa estar dentro de temperatureRange.

Exemplos

Defina o dispositivo para 350 graus Fahrenheit.

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

Ocorreu um erro ao definir a temperatura-alvo.

Valores compatíveis:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Exemplos de declarações

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 på 100 grader

ERROS no dispositivo

Veja a lista completa de erros e exceções.