風扇結構定義

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 秒」

錯誤

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

錯誤訊息 RPC 疑難排解
無法使用溫度控制器風扇。 FAILED_PRECONDITION 溫度控制器沒有風扇。這部裝置不支援粉絲相關特徵和指令。

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