智慧型住宅溫度控制特徵

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

裝置錯誤

查看完整清單 錯誤和例外狀況。