粉絲結構定義

Nest Thermostat 

sdm.devices.traits.Fan

這個特徵屬於任何具有系統控制風扇功能的裝置。

欄位

欄位 說明 資料類型
timerMode 目前的計時器模式。 string
值：「ON」、「OFF」
timerTimeout 時間戳記 (採用 RFC 3339 格式)，當時間戳記到達時，計時器模式會變成「關閉」。 string
示例：「2019-05-10T03:22:54Z」

GET 要求和回應範例

要求

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

回應

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

指令

SetTimer

變更風扇計時器。

SetTimer 要求和回應

要求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

回應

{}

SetTimer 要求欄位

欄位 說明 資料類型
timerMode 設定風扇計時器的模式。 string
值：「ON」、「OFF」
duration 選填。指定計時器的執行時間長度 (以秒為單位)。 string
範圍：「1 秒」到「43200 秒」
預設值：「900 秒」

錯誤

系統可能會傳回下列與此特徵相關的錯誤代碼：

錯誤訊息 單次點擊收益 疑難排解
溫度控制器風扇無法使用。 FAILED_PRECONDITION 溫度控制器沒有風扇功能。此裝置無法使用風扇相關特徵和指令。

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