粉絲結構定義

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 秒」設為「43200s」
預設值為「900s」

錯誤

系統可能會傳回與這個特徵相關的以下錯誤代碼：

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

請參閱 API 錯誤代碼參考資料： API 錯誤代碼的完整清單