自动化触发器
概述
自动化触发器允许用户在物联网设备间配置条件逻辑,当某一设备发生特定事件(如检测到运动、亮度下降)时,自动触发一个或多个设备执行预设动作。用户可据此创建符合个性化需求的智能自动化场景——例如“检测到运动时,自动开启走廊灯光”。
使用场景
- 为用户提供无感 化智能环境。
- 支持零代码自定义自动化规则。
- 通过情境触发设备动作降低能耗。
- 促进多设备联动,实现无缝自动化。
相关实体
| 实体 | 描述 |
|---|---|
| 终端用户 | 创建并管理自动化触发器的用户。 |
| 节点 | RainMaker 生态中生成事件或接收动作指令的物联网设备。 |
| 事件 | 基于单节点参数的条件判断(如 Brightness > 70)。 |
| 动作 | 当事件条件满足时,向一个或多个节点发送的命令或数据载荷。 |
| 自动化触发器 | 将事件与动作关联的配置规则。 |
使用指南
API 调用(客户端与云端通信)
API 基础路径:/v1/user/node_automation
(请将 v1 替换为实际版本号)
| 操作 | 请求方法 | 端点 | 描述 | Swagger 文档 |
|---|---|---|---|---|
| 创建触发 器 | POST | /user/node_automation | 新增自动化触发器 | 查看 |
| 更新触发器 | PUT | /user/node_automation | 修改现有触发器 | 查看 |
| 获取触发器 | GET | /user/node_automation | 查询触发器列表 | 查看 |
| 删除触发器 | DELETE | /user/node_automation | 移除指定触发器 | 查看 |
示例:创建自动化触发器
POST /v1/user/node_automation
JSON 载荷(点击折叠)
{
"name": "automation_name",
"node_id": "node_id",
"event_type": "node_params",
"metadata": "metadata",
"events": [
{
"params": {
"Light": {
"Brightness": 100
}
},
"check": "=="
}
],
"event_operator": "and",
"actions": [
{
"node_id": "node_id",
"params": {
"Light": {
"Output": true
}
}
}
],
"retrigger": false
}
前提条件
- 用户已完成 RainMaker 设备的入网配置(节点添加)。
- 仅当节点上报参数变更时才会触发事件判断。