Esquema do traço de controle de temperatura da casa inteligente

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

Isso é diferente da característica TemperatureSetting, que é específica para controles de termostato. A característica TemperatureSetting representa a temperatura ambiente (ambiente/externa) e não deve ser usada para controlar a temperatura de um dispositivo específico. Para controlar a temperatura de um dispositivo específico, você precisa usar a característica TemperatureControl.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
temperatureRange Object

Obrigatório.

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

Obrigatório.

Temperatura mínima para o intervalo, em graus Celsius.
maxThresholdCelsius Número

Obrigatório.

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

Especifica a etapa de temperatura relativa. Este é o intervalo mínimo de ajuste com suporte do 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.

Os valores suportados são:

C
F
commandOnlyTemperatureControl Booleano

Padrão: false.

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

Padrão: false.

Obrigatório se o dispositivo permitir a execução somente de consulta. Esse atributo indica se o dispositivo só pode ser consultado em busca de informações de estado e não pode ser controlado.

Exemplos

Dispositivo com suporte ao controle entre 150 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 informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
temperatureSetpointCelsius Número

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

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

Exemplos

Qual é a temperatura definida no dispositivo?

{
  "temperatureSetpointCelsius": 150
}

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.SetTemperature

Define a temperatura como um valor específico.

Parâmetros

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

Obrigatório.

A temperatura a ser definida, em graus Celsius. Deve 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 desejada.

Os valores suportados são:

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 DO Dispositivo

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