智慧型家用計時器結構定義

action.devices.traits.Timer - 計時器特徵是裝置上的計時器。

舉例來說，智慧型灑水器控制器或智慧型燈具開關可能會內建內建計時器。此信號可用於控制裝置的內建計時器，例如啟動新的計時器、暫停和取消執行中的計時器，以及詢問剩餘的時間。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求。

屬性	類型	說明
maxTimerLimitSec	整數	必要。 指出裝置可用的最長計時器設定 (以秒為單位)。
commandOnlyTimer	布林	(預設值：false) 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法針對此特性回應 QUERY 意圖或報告狀態，請將這項屬性設為 true。

範例

限制裝置 2 小時。

{
  "maxTimerLimitSec": 7200
}

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求。

州	類型	說明
timerRemainingSec	整數	必要。 目前時間，以秒為單位 (-1 或 [0, maxTimerLimitSec]。設為 -1 表示未執行任何計時器)。
timerPaused	布林	如果已有有效計時器但目前已暫停，則為 True。

範例

裝置計時器還剩多久？(未放送)。

{
  "timerRemainingSec": -1
}

裝置計時器還剩多久？(執行中)。

{
  "timerRemainingSec": 60
}

裝置計時器還剩多久？(已暫停)。

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

裝置指令

具有此特性的裝置可能會回應 EXECUTE 作業中的下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱意圖執行要求。

action.devices.commands.TimerStart

開始新的計時器。

參數

參數	類型	說明
timerTimeSec	整數	必要。 計時器的時間長度，以秒為單位 (必須是 [1, maxTimerLimitSec])。

範例

執行裝置五分鐘。

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

相關錯誤

啟動計時器時發生錯誤。

支援的值：

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

調整計時器時間長度。

參數

參數	類型	說明
timerTimeSec	整數	必要。 計時器的正數調整或負值 (以秒為單位)，必須介於 [-maxTimerLimitSec, maxTimerLimitSec] 內。

範例

增加裝置計時器一分鐘。

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

從裝置計時器減去 30 秒。

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

相關錯誤

調整計時器時發生錯誤。

支援的值：

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

暫停計時器。

參數

參數	類型	說明
沒有任何資源

範例

暫停裝置計時器。

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

相關錯誤

暫停計時器時發生錯誤。

支援的值：

noTimerExists

action.devices.commands.TimerResume

繼續計時。

參數

參數	類型	說明
沒有任何資源

範例

恢復裝置計時器。

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

相關錯誤

恢復計時器時發生錯誤，

支援的值：

noTimerExists

action.devices.commands.TimerCancel

取消計時器。

參數

參數	類型	說明
沒有任何資源

範例

停止裝置計時器。

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

相關錯誤

停止計時器時發生錯誤。

支援的值：

noTimerExists

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。