动作
约 1912 字大约 6 分钟
动作
动作是自动化的"执行内容"，定义了满足触发和条件后，最终要执行的操作。
通俗理解
就像自动控制系统的"执行机构"，比如"开启阀门"、"启动电机"、"发送告警"。
动作类型
ThingsCloud 支持多种动作类型，可以灵活组合实现复杂的业务逻辑。
| 动作类型 | 用途 | 典型场景 |
|---|---|---|
| 下发属性到设备 | 向设备下发属性值 | 打开开关、设置温度 |
| 更新云端属性 | 修改设备的云端私有属性值 | 修改LED屏幕信息、记录状态 |
| 执行任务 | 运行设备的任务 | 重启设备、查询状态 |
| 执行场景 | 触发另一个场景执行 | 复用已有场景 |
| 延迟 | 等待一段时间 | 延时关灯、分阶段执行 |
动作是必须的
至少需要一个动作。动作按列表顺序依次执行。
下发属性到设备
向设备下发属性，实现远程控制设备或下发配置信息。
相关文档
详细了解属性下发功能。
配置步骤
- 选择设备 - 选择要控制的设备
- 添加属性 - 点击添加属性
- 选择属性 - 选择要控制的属性
- 选择操作 - 选择设置方式
- 输入值 - 设置属性值
操作类型说明
数值型属性
| 操作 | 含义 | 示例 |
|---|---|---|
| 设置为 | 将属性设为指定值 | 温度设为26 |
| 引用 | 设为其他设备属性的值 | 温度设为室外温度 |
| 增加 | 在现有值基础上增加 | 亮度增加10 |
| 减少 | 在现有值基础上减少 | 音量减少5 |
| 增加百分比 | 在现有值基础上增加百分比 | 功率增加20% |
| 减少百分比 | 在现有值基础上减少百分比 | 亮度减少30% |
布尔型属性
| 操作 | 含义 | 示例 |
|---|---|---|
| 设置为 | 设为ON或OFF | 开关设为ON |
| 引用 | 设为其他设备属性的值 | 开关跟随主灯状态 |
| 取反 | ON变OFF，OFF变ON | 开关状态翻转 |
字符串/枚举型属性
| 操作 | 含义 | 示例 |
|---|---|---|
| 设置为 | 设为指定文本/枚举值 | 模式设为"自动" |
| 引用 | 设为其他设备属性的值 | 名称跟随设备A |
| 清空 | 清空属性值 | 清空备注内容 |
引用模式
引用模式允许将一个设备的属性值复制到另一个设备。
使用场景
- 光照联动：室内灯亮度跟随室外光照自动调节
- 温度同步：多个空调设定温度保持一致
- 主从控制：一个主开关控制多个从设备
配置示例
动作：下发属性
设备：室内灯
属性：亮度
操作：引用
引用源设备：室外光照传感器
引用源属性：光照值
效果：室内灯的亮度 = 室外光照传感器的光照值
配置示例
| 场景 | 设备 | 属性设置 |
|---|---|---|
| 打开空调并设置26度 | 空调控制器 | ①开关-设置为-ON ②设定温度-设置为-26 |
| 开关状态翻转 | 智能灯 | 开关-取反 |
| 亮度跟随室外亮度 | 室内灯 | 亮度-引用-室外光照传感器-光照值 |
| 清空设备备注 | 任意设备 | 备注-清空 |
注意
属性下发会通过网络发送到物理设备，设备需要在线才能成功执行。如设备离线，属性下发可能无法送达。
更新云端属性
用于修改设备在平台定义的云端私有属性值，不会下发给设备。
配置示例
| 场景 | 设备 | 属性更新 |
|---|---|---|
| 标记设备已维护 | 电机设备 | 维护状态-设置为-"已维护" |
| 记录上次检查时间 | 传感器 | 上次检查-设置为-当前时间 |
| 更新设备别名 | 任意设备 | 别名-设置为-"一楼大厅灯" |
适用场景
当您只需要在平台上记录某些状态或配置，而不需要通知设备时，使用"更新云端属性"。
执行任务
执行任务动作用于让设备执行一个预定义的任务。
什么是任务？
任务是在设备类型管理中预先定义的操作指令，例如：
- 重启设备
- 恢复出厂设置
- 查询设备状态
- 升级固件
- 校准传感器
- 拍摄照片
配置步骤
- 选择设备 - 选择目标设备
- 选择任务 - 选择要执行的任务
配置示例
| 场景 | 设备 | 选择任务 |
|---|---|---|
| 每天凌晨重启网关 | 网关设备 | 重启设备 |
| 每周校准传感器 | 温湿度传感器 | 校准传感器 |
| 定期采集数据 | 环境监测设备 | 状态上报 |
执行场景
执行场景动作用于触发另一个场景的执行，实现场景的嵌套和复用。
配置步骤
- 选择场景 - 选择要执行的场景
- 设置等待选项 - 是否等待场景执行完成
等待选项说明
| 等待设置 | 说明 | 适用场景 |
|---|---|---|
| 等待完成（是） | 当前自动化暂停，等待场景执行完毕后继续 | 开灯后需要等灯亮了再调亮度 |
| 不等待（否） | 触发场景后立即继续执行，两个流程并行 | 同时执行多个独立操作 |
配置示例
| 场景 | 场景选择 | 等待设置 |
|---|---|---|
| 先开灯，等灯亮了再调亮度 | 开启所有灯 | 等待完成 |
| 同时开灯和开空调 | 开启空调 | 不等待 |
注意
如果被调用的场景被停用或删除，自动化执行到此动作时会报错并停止。
延迟
延迟动作用于在动作之间插入等待时间，实现分阶段执行。
配置说明
| 配置项 | 选项 | 说明 |
|---|---|---|
| 时间单位 | 秒 | 适合短时间延迟（1-60 秒） |
| 分钟 | 适合中等延迟（1-60 分钟） | |
| 小时 | 适合长时间延迟（1-24 小时） | |
| 延迟时长 | 正整数 | 延迟的具体数值 |
配置示例
| 场景 | 单位 | 时长 | 总延迟 |
|---|---|---|---|
| 设备启动后等待 | 秒 | 30 | 30 秒 |
| 灌溉持续 | 分钟 | 10 | 10 分钟 |
| 周期检查 | 小时 | 2 | 2 小时 |
实际效果
动作序列示例：
1. 下发属性：开灯
2. 延迟：5 分钟
3. 下发属性：关灯
实际执行：开灯 → 等待 5 分钟 → 关灯
提示
延迟期间自动化处于等待状态。如果需要取消正在等待的自动化，请停用该自动化规则。
动作顺序
动作按列表从上到下依次执行。您可以通过拖拽调整动作顺序。
执行顺序示例
1. 下发属性：开灯
2. 延迟：30 秒
3. 下发属性：开空调
4. 执行场景：节能模式
执行流程：开灯 → 等待 30 秒 → 开空调 → 执行节能场景
动作启用/停用
每个动作可以单独启用或停用：
- 启用（绿色）：动作会正常执行
- 停用（灰色）：动作会被跳过
使用场景
- 调试时临时禁用某些动作
- 保留配置但暂时不需要执行
- 逐步启用复杂自动化中的各个步骤
下一步
了解动作后，您可以继续学习：