智慧型住宅溫度控制特徵結構定義

action.devices.traits.TemperatureControl：裝置 (溫度控制器除外) 的屬性，可控制裝置內部或周圍的溫度。

這與 TemperatureSetting 特徵不同，後者專門用於溫度控制器類型的控制項。TemperatureSetting 特徵代表環境 (室內/室外) 溫度，不應用於控制特定裝置的溫度。如要控制特定裝置的溫度，您必須使用 TemperatureControl 特徵。

裝置屬性

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

屬性 類型 說明
temperatureRange 物件

必填。

裝置支援的溫度範圍。
minThresholdCelsius Number

必填。

範圍內的最低溫度，單位為攝氏度。
maxThresholdCelsius Number

必填。

範圍的最高溫度，單位為攝氏度。
temperatureStepCelsius Number

指定相對溫度步驟。這是裝置支援的最短調整間隔。如果未指定，系統會以 temperatureRange 的百分比計算相對步驟。
temperatureUnitForUX String

必填。

回覆使用者時使用的溫度單位。

支援的值：

C
F
commandOnlyTemperatureControl 布林值

(預設值：false)

指出裝置是否支援使用單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或回報狀態，請將這個屬性設為 true。
queryOnlyTemperatureControl 布林值

(預設值：false)

如果裝置支援僅執行查詢，則為必要屬性。這個屬性會指出裝置是否只能查詢狀態資訊，而無法控制裝置。

範例

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

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

裝置狀態

具有此特徵的實體可能會在 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
  • 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

裝置錯誤

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