Smart Home TemperatureControl 特徵結構定義

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

裝置錯誤

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