Smart Home TemperatureControl Trait Schema

action.devices.traits.TemperatureControl - 适用于支持控制设备内部或周围温度的设备（温控器除外）的特征。

这与 TemperatureSetting trait 不同，后者专门用于温控器式控件。TemperatureSetting trait 表示环境（室内/室外）温度，不应用于控制特定设备的温度。如需控制特定设备的温度，您必须使用 TemperatureControl trait。

设备属性

具有此 trait 的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅intent 执行方式。

属性 类型 说明
temperatureRange 对象

必填。

设备支持的温度范围。
minThresholdCelsius 编号

必填。

范围的最低温度（摄氏度）。
maxThresholdCelsius 编号

必填。

范围的最高温度（摄氏度）。
temperatureStepCelsius 编号

指定相对温度步长。这是设备支持的最小调整间隔。如果未指定，相对步数将按 temperatureRange 的百分比计算。
temperatureUnitForUX String

必填。

在向用户提供回答时使用的温度单位。

支持的值：

C
F
commandOnlyTemperatureControl 布尔值

（默认值：false）

指示设备是否支持使用单向（true）或双向（false）通信。如果设备无法响应此 trait 的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyTemperatureControl 布尔值

（默认值：false）

如果设备支持仅查询执行，则必需。此属性用于指明是否只能查询设备的状态信息，而无法控制设备。

示例

设备支持在 150 到 500 华氏度之间以 5 度为单位进行控制。

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

设备状态

具有此 trait 的实体可能会在 QUERY 操作期间报告以下状态。如需详细了解如何处理 QUERY intent，请参阅intent 执行方式。

州 类型 说明
temperatureSetpointCelsius 编号

当前温度设定值，单位为摄氏度。必须在 temperatureRange 内。如果 queryOnlyTemperatureControl 设置为 false，则为必需
temperatureAmbientCelsius 编号

当前观测到的温度，单位为摄氏度。必须在 temperatureRange 内。

示例

设备设为多少度？

{
  "temperatureSetpointCelsius": 150
}

设备命令

具有此 trait 的设备可能会在 EXECUTE 操作期间响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅intent 执行方式。

action.devices.commands.SetTemperature

将温度设为特定值。

参数

参数 类型 说明
temperature 编号

必填。

要设置的温度（摄氏度）。必须在 temperatureRange 内。

示例

将设备温度设为 350 华氏度。

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

设置目标温度时出错。

支持的值：

alreadyAtMax
alreadyAtMin
valueOutOfRange

示例话语

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

设备错误

查看错误和异常的完整列表。