Smart Home TemperatureControl Trait 結構定義
action.devices.traits.TemperatureControl
- 可讓溫度控制器 (不論是溫度控制器以外) 支援在裝置內部或周圍控制溫度的裝置。
這與溫度控制器溫度控制項專用的 TemperatureSetting 特性不同。TemperatureSetting 特性代表環境 (室內/戶外) 溫度,不應用來控制特定裝置的溫度。若要控制特定裝置的溫度,您必須使用 TemperatureControl 特性。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
temperatureRange |
物件 |
必填。 裝置支援的溫度範圍。 |
minThresholdCelsius |
Number |
必填。 範圍的最低溫度,單位為攝氏。 |
maxThresholdCelsius |
Number |
必填。 範圍的最大溫度 (以攝氏為單位)。 |
temperatureStepCelsius |
Number |
指定相對溫度步驟。這是裝置支援的最小調整間隔。如果未指定,則相對步驟會以 |
temperatureUnitForUX |
字串 |
必填。 向使用者回應的溫度單位。 支援的值:
|
commandOnlyTemperatureControl |
布林 |
(預設: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
queryOnlyTemperatureControl |
布林 |
(預設: 如果裝置支援查詢功能,則為必要屬性。這個屬性可指出裝置是否只能查詢狀態資訊,而且無法控制。 |
範例
裝置支援控制溫度在 150 到 500 度之間,以 5 度為單位遞增。
{ "temperatureRange": { "minThresholdCelsius": 65.5, "maxThresholdCelsius": 260 }, "temperatureStepCelsius": 2.778, "temperatureUnitForUX": "F" }
裝置狀態:STATE
具有此特性的裝置可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
temperatureSetpointCelsius |
Number |
目前溫度設定點 (攝氏)。必須在 |
temperatureAmbientCelsius |
Number |
目前觀察到的溫度,單位為攝氏。必須在 |
範例
裝置的溫度是幾度?
{ "temperatureSetpointCelsius": 150 }
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.SetTemperature
將溫度設為特定的值。
參數
參數 | 類型 | 說明 |
---|---|---|
temperature |
Number |
必填。 設定的溫度,以攝氏為單位。必須在 |
範例
將裝置設為華氏 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
en-US
-
I want the temperature of
the oven higher -
set
the oven to400
es-ES
-
pon la temperatura del
horno a180 grados -
sube la temperatura del
horno
fr-FR
-
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 -
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
pt-BR
-
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
-
höj temperaturen i
ugnen -
sätt
ugnen på100 grader