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