智能家居 TemperatureControl 特征架构

action.devices.traits.TemperatureControl - 支持在设备内部或周围控制温度的设备(温控器除外)的特征。

这与 TemperatureSetting 特征不同,后者专门用于温控器样式的控件。TemperatureSetting 特征表示环境(室内/室外)温度,不应用于控制特定设备的温度。为了控制特定设备的温度,您必须使用 TemperatureControl 特征。

设备属性

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

属性 类型 说明
temperatureRange 对象

必填。

设备支持的温度范围。

minThresholdCelsius 编号

必填。

范围内的最低温度(以摄氏度为单位)。

maxThresholdCelsius 编号

必填。

范围内的最高温度(以摄氏度为单位)。

temperatureStepCelsius 编号

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

temperatureUnitForUX String

必填。

用于响应用户的温度单位。

支持的值:

C
F
commandOnlyTemperatureControl Boolean

(默认值:false

指明设备是否支持使用单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。

queryOnlyTemperatureControl Boolean

(默认值:false

如果设备支持仅执行查询,则为必需。此属性指示设备是否只能查询状态信息,且无法控制。

示例

支持以 5 度为增量控制的 150 华氏度到 500 华氏度的设备。

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

设备状态

具有此特征的实体可能会在 QUERY 操作过程中报告以下状态。如需详细了解如何处理 QUERY intent,请参阅 intent 执行方式

类型 说明
temperatureSetpointCelsius 编号

当前温度设定值(以摄氏度为单位)。必须在 temperatureRange 以内。如果 queryOnlyTemperatureControl 设置为 false,则必须提供此值

temperatureAmbientCelsius 编号

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

示例

设备当前的温度是多少?

{
  "temperatureSetpointCelsius": 150
}

设备命令

具有此特征的设备可能会在 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 100 grader

设备出错

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