智能家居温度控制特征架构
action.devices.traits.TemperatureControl
- 支持在设备内或设备周围控制温度的设备(温控器除外)的特征。
这与专门用于温控器样式控制的 TemperatureSetting 特征不同。TemperatureSetting 特征表示环境(室内/室外)温度,不应用于控制特定设备的温度。如需控制特定设备的温度,你必须使用 TemperatureControl 特征。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
temperatureRange |
对象 |
必填。 设备支持的温度范围。 |
minThresholdCelsius |
编号 |
必填。 范围的最小温度(以摄氏度为单位)。 |
maxThresholdCelsius |
编号 |
必填。 范围的最高温度(以摄氏度为单位)。 |
temperatureStepCelsius |
编号 |
指定相对温度步长。这是设备支持的最小调整间隔。如果未指定,相对步数将以 |
temperatureUnitForUX |
String |
必填。 响应用户时使用的温度单位。 支持的值:
|
commandOnlyTemperatureControl |
Boolean |
(默认值: 指明设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
queryOnlyTemperatureControl |
Boolean |
(默认值: 如果设备支持只执行查询,则必须提供。此属性指示是否只能查询设备以获取状态信息,且无法控制。 |
示例
设备支持范围为 150 到 500 华氏度,以 5 度为增量。
{ "temperatureRange": { "minThresholdCelsius": 65.5, "maxThresholdCelsius": 260 }, "temperatureStepCelsius": 2.778, "temperatureUnitForUX": "F" }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
temperatureSetpointCelsius |
编号 |
当前温度设定值,以摄氏度为单位。必须在 |
temperatureAmbientCelsius |
编号 |
当前观测到的温度(以摄氏度为单位)。必须在 |
示例
设备要设成多少度?
{ "temperatureSetpointCelsius": 150 }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.SetTemperature
将温度设置为特定值。
参数
参数 | 类型 | 说明 |
---|---|---|
temperature |
编号 |
必填。 要设置的温度(以摄氏度为单位)。必须在 |
示例
将设备设为 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 auf425 Grad -
Wie warm ist
der Ofen
en-US
-
I want the temperature of
the oven higher -
current temperature in
the fridge -
set
the oven to400
es-ES
-
pon la temperatura del
horno a180 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 a200 gradi
ja-JP
-
オーブン の温度は何度 -
オーブン の温度を425度 に設定して -
オーブン の温度を上げて
ko-KR
-
오븐 온도180 도로 맞춰 -
오븐 온도 몇 도야 -
오븐 온도 좀 높여 줄래
nl-NL
-
stel
de oven in op220 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 para180 graus -
aumenta a temperatura do
forno -
aumentar a temperatura do
forno -
define a temperatura do
termostato nos22 graus
sv-SE
-
Vad är det för temperatur i
ugnen ? -
höj temperaturen i
ugnen -
sätt
ugnen på100 grader