PoBDS文档
Englishv1.0.0
POBDS / 12

节点、类型与生命周期参考

查阅连接规则、常用操作、Action 完成语义和配置文件格式。

引脚与数据类型

类型典型用途连接注意事项
执行流入口、Action、BDS、子节点流只连接执行输入,不是数值。
Bool门槛、AND / OR / NOT、比较结果不能直接作为整数评分。
Int / Float数值运算、比较、参数与变量按具体类型匹配,不进行任意隐式转换。
Vector2 / Vector3位置、方向、向量运算可以展开组件输出;每个组件有自己的标量类型。
Color颜色值可展开 RGBA。
Actor自身、目标、角色变量对象引用;支持空值检查和类型匹配的角色成员访问。
评分 / ContextAbility 到 Evaluation 的评分上下文不是随意连接的普通数值输出。

常用数据节点

  • 数值:加、减、乘、除、最小值、最大值。除法要明确整数截断和除数为 0 的处理。
  • 向量:相加、相减、方向归一化、组件读取。浮点向量用于表现时,要与整数模拟边界区分。
  • 比较:先确定两端类型,再选择等于、不等于、大小比较等允许的操作。Actor 等引用只能使用合理的引用判断,不能进行大小排序。
  • 随机整数:Min / Max 是输入,随机值是输出;千分比可用 1–1000 后比较 ≤ 阈值,万分比用 1–10000。
  • 输入模板:未连接时直接填写字面量,连接后禁用该字段;断线后恢复本地值编辑。

Action 的 Enter / Update / Exit

Action 生命周期与多动作完成规则。 · 点击查看原图

进入节点时初始化 Action;后续帧更新未完成的持续 Action;离开节点时执行清理。多个 Action 都完成后,节点自动发送 FINISHED 并根据执行线流转,完成事件字段留空也不阻止这一行为。

配置 / 情况结果
每帧执行的持续 Action继续 Update,直到它的逻辑调用完成或失败。
一次性完成的 Action不必重复每帧执行;不能因此让其他持续 Action 提前结束。
全部完成节点发出 FINISHED;流程可以连到下一节点或函数返回。
失败按 FAILED 或配置的失败事件处理。
被上层抢占Exit 清理原分支;不发送伪成功。

Action 完成如何通知 BDS?

Action 调用 Finish() → 同一节点内全部 Action 完成 → 节点自动发出 FINISHED → 执行后续节点;到达函数返回,或末尾节点没有后续执行线时,整条行为流完成。BDS 检测到行为流结束,通知 OnAbilityFinished,再从本帧已评估的可用候选中重选。完成事件字段留空不会阻止这条链路,不需要再手动发送一个“Ability 完成”事件。

普通候选需要等待当前整条行为流完成;更高分且允许强制抢占的新候选可提前退出旧分支。完成后如果原 Ability 仍是最高分、没有进入冷却,它也可能再次执行,并不保证一定切换到另一条 Ability。

常用编辑快捷键

快捷键 / 操作用途
空白拖框 / 多选选择多个节点后批量对齐、分布或折叠。
Delete删除所选节点。
Home / F适配全图 / 定位所选节点。
Ctrl + Shift + L自动整理布局。
[ / ]折叠 / 展开所选节点。
Ctrl + Space节点与命令搜索;支持分类路径筛选。
双击调用节点打开引用的 BDS 或节点流;无配置时进入创建流程。
工作区回退 / 前进按跨图访问路径导航。

State 和 Action 的生命周期

节点如何运行何时离开
State进入、更新、退出分别运行 Enter、Update、Exit 事件图。适合巡逻、瞄准等需要持续驻留的状态。匹配条件或事件后离开;先执行该 State 的 Exit,再进入目标节点。
Action启用的动作依次进入;每帧更新尚未完成的动作。延迟启动的动作也计入等待。全部动作结束后,节点发出 FINISHED 或 FAILED,再查找匹配的执行连线。
函数返回先读取返回针脚上的值。完成当前图,并向调用方交付返回值。
图退出事件本图停止时执行清理动作。正常完成、抢占和异常停止都会触发,每次运行只触发一次。

State 的简单事件图用 In,在进入状态时运行一次。完整事件图有 Enter、Update、Exit 三个入口,可分别配置。默认在对应阶段运行所有已启用的可视事件;开启顺序执行时,当前事件到达 Out 后推进下一项。涉及整图资源的释放放在图退出事件中。

事件驱动的流转与全局事件

  • 节点级 FINISHED / FAILED 由节点在所有启用的 Action 结束后发出。Action 的「完成时」可以留空;填自定义事件时,该事件会等同节点其余 Action 结束后再处理。
  • 同一事件先尝试当前节点上匹配的执行出口。没有可用出口时,再查找本图匹配的事件监听节点。可在监听节点填入 Alert,并将出口连到对应 State。
  • 发送事件节点可发送当前图事件,或开启全局发送。宿主也可调用 PoBDSEventManager.Instance.SendGlobalEvent("Alert"),图级订阅由启用了全局监听的事件节点声明。正在执行 Action 时,事件先排队。
  • BDS 每帧独立评分。允许强制抢占的候选可以结束旧行为;被抢占的分支会执行清理。

让多个子图并行运行

同一个 Ability 同时运行走位与射击子图。 · 点击查看原图
  1. 在 BDS 中给同一 Ability 添加分支

    选中执行节点,执行类型选择「节点流」,点「+ 添加节点流」。例如把 Orbit 放在第一条,把射击子图放在第二条。双击执行节点可选择打开其中一条。

  2. 选择入参来源

    节点流 1 可绑定调用入参与返回值,其他子图使用各自的默认入参。各分支有独立的图内变量,同一角色下可共享角色全局变量。

  3. 设置完成条件

    只有全部分支结束时 Ability 才完成。任一分支需要持续运行时,整个 Ability 会继续执行,直到分支结束或被抢占。

  4. 在节点流内组合多个子图

    使用节点流编辑器的「并行」节点配置多个子图。分支都退出后,父流程才继续。简单的多个动作也可放在同一个 Action 节点中共同更新。

图退出事件与清理

正常完成、强制退出和异常停止共享同一条清理路径。 · 点击查看原图
  1. 放置图退出事件

    在节点流画布右键搜索「图退出事件」,从右侧执行针脚连到一个动作节点,再给动作方法接好数据针脚。也可以在退出事件的检查器里保留内嵌清理动作。

  2. 配置一次性清理

    例如用「设置变量」把角色全局 Bool Global/IsFiring 设为 false,再调用角色的即时方法释放占用的掩体。退出时先执行内嵌动作,再执行直接连接的动作节点。每项只执行 Enter 和 Exit,跳过 Update、延迟与后续执行连线。

  3. 验证正常与强制退出

    从函数返回或图的终点正常结束、调用 Stop()、被 BDS 抢占以及运行错误导致停止时,都会执行清理。当前节点先 Exit,停止嵌套调用时子图先清理,之后才清理父图。

清理期间仍可读本图的局部变量和入参,角色全局变量的写入会保留到后续行为。正常返回的值在清理前取样。清理动作同步执行,适合立即释放资源、关闭状态或写变量。

行为执行器的对象池

同一根 AI 的仿真时钟管理行为节点流和子 BDS 的空闲执行器。行为完成、被打断或退出时,先执行 Exit 并退出后代,再回收到池中;回调仍在执行时延后回收,防止新行为复用正在退出的上下文。

重新取出时,清除局部变量、入参、返回值、待处理事件、冷却和调试状态,再绑定新的配置、Actor 与调用参数。角色全局变量属于 Agent,跨行为保留,且不同角色互不共享。调试与历史通过执行实例标识区分每次调用。

通过 runner.SimulationClock.ExecutionPool 设置 Capacity(每类空闲缓存默认 32)、查看 CachedFlows / CachedBds 与 CreatedFlows / CreatedBds,或调用 Clear() 释放空闲缓存。Capacity=0 关闭缓存,不限制活跃嵌套深度。对象池减少执行器反复创建;Action 实例、参数绑定及开启历史采集仍可能分配内存,不能把频繁切换宣称为零 GC。

配置文件与二进制

AI 配置的 .bytes 是序列化后的配置数据,不是 C# 角色类。当前序列化层支持 PBDS 二进制及完整性校验,并保留旧 JSON 的读取兼容。编辑器可识别并双击打开适用配置;把文本改扩展名为 .bytes 并不等于有效二进制。

迁移资源时保留 Unity .meta 和引用关系。不要在运行时从 Packages 的编辑器目录加载项目配置;使用资源目录、资源管理系统或宿主注入的加载器。

支持多个关键词与 / 路径组合 · Enter 打开第一项 · Esc 关闭