智能家居计时器特征架构

action.devices.traits.Timer - 计时器特征表示设备上的计时器。

例如，智能洒水器控制器或智能灯 开关可能具有内置计时器。此 trait 可用于控制内置计时器， 设备，例如启动新计时器、暂停和取消正在运行的计时器；以及 询问剩余时间

设备属性

具有此特征的设备可能会报告以下内容 作为 SYNC 操作的一部分。学习内容 有关处理 SYNC intent 的更多信息，请参阅 intent 执行方式。

属性 类型 说明
maxTimerLimitSec 整数

必填。

表示设备上可用的最长计时器设置（以秒为单位）。
commandOnlyTimer 布尔值

（默认值：false）

指示设备支持使用单向 (true) 还是双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设置为 true。

示例

设备设有 2 小时计时器。

{
  "maxTimerLimitSec": 7200
}

设备状态

具有此特征的实体可能会报告以下内容 QUERY 操作包含的指定状态。学习内容 有关处理 QUERY intent 的更多信息，请参阅 intent 执行方式。

州 类型 说明
timerRemainingSec 整数

必填。

当前剩余时间（以秒为单位、-1 或 [0, maxTimerLimitSec]）。设置为 -1 表示没有计时器在运行。
timerPaused 布尔值

如果存在进行中的计时器，但该计时器当前处于暂停状态，则为 True。

示例

设备计时器还剩多长时间？（未运行）。

{
  "timerRemainingSec": -1
}

设备计时器还剩多长时间？（正在运行）。

{
  "timerRemainingSec": 60
}

设备计时器还剩多长时间？（已暂停）。

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

设备命令

具有此特征的设备可能会响应以下内容 作为 EXECUTE 操作的一部分。学习内容 有关处理 EXECUTE intent 的更多信息，请参阅 intent 执行方式。

action.devices.commands.TimerStart

启动一个新计时器。

参数

参数 类型 说明
timerTimeSec 整数

必填。

计时器的持续时间（以秒为单位）；必须在 [1, maxTimerLimitSec] 范围内。

示例

让设备计时器运行 5 分钟。

{
  "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

设备错误

查看完整列表 错误和异常。