While循环 (NodeWhileLoop)

📖 节点概述

条件驱动的循环节点，只要 Condition 引脚收到 True，就会反复执行 循环体 内的逻辑，直到条件变为 False 才会退出。相当于编程中的 while (条件) { … }，适合不确定循环次数的动态重复任务。

💡 使用场景：

• 轮询等待：不断检查某个状态（如“下载是否完成”），一旦满足条件就跳出循环。
• 重试机制：尝试连接服务器，失败则等待一段时间后再次尝试，直到连接成功或达到最大次数。
• 持续监控：循环读取传感器数据，当数值超过阈值时触发报警并退出。
• 动态列表处理：配合 跳出循环 节点，在内部手动控制循环的终止时机。

🎮 实战连线指南：如何正确使用它？

While 循环会在每一轮执行前评估 Condition 引脚的值。如果 Condition 没有被外部连线，就会使用节点上的“默认条件”开关（默认开启），此时循环会无限运行，直到内部主动 break。

场景案例：重试下载文件，直到成功或达到最大重试次数

1. 准备计数器：使用 变量设置 节点创建一个 retry_count 变量，初始值为 0。
2. 构建循环条件：将 retry_count < 5 的判断结果连入【While循环】的 Condition 引脚。
3. 构建循环体：
   • 将【While循环】的 循环体 输出连接到【下载文件】节点。
   • 下载成功时，使用 跳出循环 节点终止循环。
   • 下载失败时，使用 变量操作 节点将 retry_count 加 1，循环会自动进入下一轮判断。
4. 结束处理：将【While循环】的 循环完成 输出连接到【显示通知】节点，报告最终结果。

防卡死延时：如果循环体内操作非常轻量（如纯计算），建议在高级设置中填写一个几毫秒的延时，防止 CPU 占用过高。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 如果 默认条件 保持开启且未连线 Condition，循环将无限运行，务必在 循环体 内通过 跳出循环 节点结束，或使用 防卡死延时 避免卡死界面。
• 在循环体内部可以使用 继续循环 节点跳过本次剩余步骤，直接开始下一轮判断。