节点、类型与生命周期参考
查阅连接规则、常用操作、Action 完成语义和配置文件格式。
引脚与数据类型
| 类型 | 典型用途 | 连接注意事项 |
|---|---|---|
| 执行流 | 入口、Action、BDS、子节点流 | 只连接执行输入,不是数值。 |
| Bool | 门槛、AND / OR / NOT、比较结果 | 不能直接作为整数评分。 |
| Int / Float | 数值运算、比较、参数与变量 | 按具体类型匹配,不进行任意隐式转换。 |
| Vector2 / Vector3 | 位置、方向、向量运算 | 可以展开组件输出;每个组件有自己的标量类型。 |
| Color | 颜色值 | 可展开 RGBA。 |
| Actor | 自身、目标、角色变量 | 对象引用;支持空值检查和类型匹配的角色成员访问。 |
| 评分 / Context | Ability 到 Evaluation 的评分上下文 | 不是随意连接的普通数值输出。 |
常用数据节点
- 数值:加、减、乘、除、最小值、最大值。除法要明确整数截断和除数为 0 的处理。
- 向量:相加、相减、方向归一化、组件读取。浮点向量用于表现时,要与整数模拟边界区分。
- 比较:先确定两端类型,再选择等于、不等于、大小比较等允许的操作。Actor 等引用只能使用合理的引用判断,不能进行大小排序。
- 随机整数:Min / Max 是输入,随机值是输出;千分比可用 1–1000 后比较 ≤ 阈值,万分比用 1–10000。
- 输入模板:未连接时直接填写字面量,连接后禁用该字段;断线后恢复本地值编辑。
Action 的 Enter / Update / Exit
进入节点时初始化 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 每帧独立评分。允许强制抢占的候选可以结束旧行为;被抢占的分支会执行清理。
让多个子图并行运行
在 BDS 中给同一 Ability 添加分支
选中执行节点,执行类型选择「节点流」,点「+ 添加节点流」。例如把 Orbit 放在第一条,把射击子图放在第二条。双击执行节点可选择打开其中一条。
选择入参来源
节点流 1 可绑定调用入参与返回值,其他子图使用各自的默认入参。各分支有独立的图内变量,同一角色下可共享角色全局变量。
设置完成条件
只有全部分支结束时 Ability 才完成。任一分支需要持续运行时,整个 Ability 会继续执行,直到分支结束或被抢占。
在节点流内组合多个子图
使用节点流编辑器的「并行」节点配置多个子图。分支都退出后,父流程才继续。简单的多个动作也可放在同一个 Action 节点中共同更新。
图退出事件与清理
放置图退出事件
在节点流画布右键搜索「图退出事件」,从右侧执行针脚连到一个动作节点,再给动作方法接好数据针脚。也可以在退出事件的检查器里保留内嵌清理动作。
配置一次性清理
例如用「设置变量」把角色全局 Bool
Global/IsFiring设为 false,再调用角色的即时方法释放占用的掩体。退出时先执行内嵌动作,再执行直接连接的动作节点。每项只执行 Enter 和 Exit,跳过 Update、延迟与后续执行连线。验证正常与强制退出
从函数返回或图的终点正常结束、调用 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 的编辑器目录加载项目配置;使用资源目录、资源管理系统或宿主注入的加载器。