Esquema de atributo TemperatureControl da casa inteligente

action.devices.traits.TemperatureControl: característica de dispositivos (exceto termostatos) que oferecem suporte ao controle de temperatura, dentro ou ao redor do dispositivo.

Isso é diferente do atributo TemperatureSetting, que é específico para controles do tipo termostato. O atributo TemperatureSetting representa a temperatura ambiente (do ambiente/externa) e não deve ser usado para controlar a temperatura de um dispositivo específico. Para controlar a temperatura de um dispositivo específico, use o atributo 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 processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
temperatureRange Object

Obrigatório.

Faixa de temperatura com suporte do dispositivo.
minThresholdCelsius Número

Obrigatório.

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 de ajuste mínimo compatível com o dispositivo. Se não forem especificadas, 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 aceitos:

C
F
commandOnlyTemperatureControl Booleano

Padrão: false.

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

Padrão: false.

Obrigatório se o dispositivo oferece suporte à execução somente de consulta. Esse atributo indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado.

Exemplos

Dispositivo com suporte a controle entre 150 e 500 graus Fahrenheit, em incrementos de 5 graus.

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

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
temperatureSetpointCelsius Número

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

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

Exemplos

Qual é a temperatura do dispositivo?

{
  "temperatureSetpointCelsius": 150
}

COMANDOS do dispositivo

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

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 desejada.

Valores aceitos:

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

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