ThermostatMode 結構定義

Nest Thermostat 

sdm.devices.traits.ThermostatMode

這類特徵屬於 THERMOSTAT 裝置類型支援不同溫度控制器模式的裝置類型。

欄位

欄位	說明	資料類型
availableModes	支援的溫度控制器模式清單。	array(string) 值：[「HEAT」、「COOL」、「HEATCOOL」、「OFF」]
mode	目前的溫度控制器模式。	string 值：「HEAT」、「COOL」、「HEATCOOL」、「OFF」

GET 要求與回應範例

要求

GET /enterprises/project-id/devices/device-id

回應

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    }
  }
}

指令

SetMode

變更溫度控制器模式。

這項特性不適用於節能模式。詳情請參閱 ThermostatEco 特徵。

SetMode 要求和回應

要求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

回應

{}

SetMode 要求欄位

欄位	說明	資料類型
mode	切換溫度控制器的模式。	string 值：「HEAT」、「COOL」、「HEATCOOL」、「OFF」

錯誤

系統可能會根據這個特徵傳回以下錯誤代碼：

錯誤訊息	RPC	疑難排解
目前的溫度控制器模式不支援指令。	FAILED_PRECONDITION	根據 ThermostatMode 特徵，部分溫度控制器型號不支援在溫度控制器關閉時變更節能模式。你必須先將溫度控制器模式變更為「暖氣」、「COOL」或「HEATCOOL」，才能變更節能模式。

如需 API 錯誤代碼的完整清單，請參閱 API 錯誤代碼參考資料。