風扇結構定義

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 錯誤代碼參考資料。