粉絲結構定義
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 錯誤代碼的完整清單