Smart Home TemperatureControl Trait 結構定義

action.devices.traits.TemperatureControl - 可讓溫度控制器 (不論是溫度控制器以外) 支援在裝置內部或周圍控制溫度的裝置。

這與溫度控制器溫度控制項專用的 TemperatureSetting 特性不同。TemperatureSetting 特性代表環境 (室內/戶外) 溫度，不應用來控制特定裝置的溫度。若要控制特定裝置的溫度，您必須使用 TemperatureControl 特性。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求一文。

屬性	類型	說明
temperatureRange	物件	必填。 裝置支援的溫度範圍。
minThresholdCelsius	Number	必填。 範圍的最低溫度，單位為攝氏。
maxThresholdCelsius	Number	必填。 範圍的最大溫度 (以攝氏為單位)。
temperatureStepCelsius	Number	指定相對溫度步驟。這是裝置支援的最小調整間隔。如果未指定，則相對步驟會以 temperatureRange 的百分比計算。
temperatureUnitForUX	字串	必填。 向使用者回應的溫度單位。 支援的值： C F
commandOnlyTemperatureControl	布林	(預設：false) 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態，請將此屬性設為 true。
queryOnlyTemperatureControl	布林	(預設：false) 如果裝置支援查詢功能，則為必要屬性。這個屬性可指出裝置是否只能查詢狀態資訊，而且無法控制。

範例

裝置支援控制溫度在 150 到 500 度之間，以 5 度為單位遞增。

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

裝置狀態：STATE

具有此特性的裝置可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求一文。

州	類型	說明
temperatureSetpointCelsius	Number	目前溫度設定點 (攝氏)。必須在 temperatureRange 內。如果 queryOnlyTemperatureControl 設為 false，則為必要欄位
temperatureAmbientCelsius	Number	目前觀察到的溫度，單位為攝氏。必須在 temperatureRange 內。

範例

裝置的溫度是幾度？

{
  "temperatureSetpointCelsius": 150
}

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱意圖執行要求一文。

action.devices.commands.SetTemperature

將溫度設為特定的值。

參數

參數	類型	說明
temperature	Number	必填。 設定的溫度，以攝氏為單位。必須在 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

en-US

• I want the temperature of the oven higher
• set the oven to 400

es-ES

• pon la temperatura del horno a 180 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 a 200 gradi

ja-JP

• オーブン の温度を 425度 に設定して
• オーブン の温度を上げて

ko-KR

• 오븐 온도 180 도로 맞춰
• 오븐 온도 좀 높여 줄래

nl-NL

• stel de oven in op 220 graden
• verhoog de temperatuur van de oven

pt-BR

• 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

• höj temperaturen i ugnen
• sätt ugnen på 100 grader

裝置錯誤：ERRORS

請參閱錯誤和例外狀況的完整清單。