智能家居计时器特征架构
action.devices.traits.Timer
- 计时器特征表示设备上的计时器。
例如,智能洒水机控制器或智能灯开关可能具有内置计时器。此特征可用于控制设备上的内置计时器,例如启动新计时器、暂停和取消正在运行的计时器,以及询问剩余时间。
设备属性
具有此特征的设备可以在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
maxTimerLimitSec |
整数 |
必填。 指明设备上可用的最长计时器设置(以秒为单位)。 |
commandOnlyTimer |
Boolean |
(默认: 指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
示例
设备设有 2 小时的计时器限制。
{ "maxTimerLimitSec": 7200 }
设备状态
具有此特征的实体可以在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
timerRemainingSec |
整数 |
必填。 当前剩余时间(以秒为单位),-1 或 [0, |
timerPaused |
Boolean |
如果存在有效的计时器,但当前已暂停,则为 true。 |
示例
设备计时器还剩多长时间?(未运行)。
{ "timerRemainingSec": -1 }
设备计时器还剩多长时间?(正在运行)。
{ "timerRemainingSec": 60 }
设备计时器还剩多长时间?(已暂停)。
{ "timerRemainingSec": 30, "timerPaused": true }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.TimerStart
启动新计时器。
参数
参数 | 类型 | 说明 |
---|---|---|
timerTimeSec |
整数 |
必填。 计时器的时长(以秒为单位);必须在 [1, |
示例
让设备计时器持续五分钟。
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
相关错误
启动计时器时出错。
支持的值:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
调整计时器时长。
参数
参数 | 类型 | 说明 |
---|---|---|
timerTimeSec |
整数 |
必填。 计时器的正负调整(以秒为单位);必须在 [ |
示例
将设备计时器增加一分钟。
{ "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