POBDS / 14
节点 API:输入、输出与使用示例
按节点查阅连接契约、参数和真实使用场景,不需要猜一个节点应该怎么接。
PoBDS 1.0.0Unity 2022.3+
先看节点契约,再连线
每个条目说明输入、输出和可验证的例子。执行线负责推进流程,数据线负责给参数提供值;颜色只是辅助,具体类型和单位才是依据。未连接的输入可在节点里填默认值,连接后字段禁用。
流程与调用
| 节点 | 输入与配置 | 输出 / 完成 | 例子 |
|---|
| 入口 / Entry | 执行起点;声明名称、类型、默认值的入参。 | 执行输出;声明的入参作为图内数据。 | 入口 → Action;Target : Actor 从调用方传入。 |
| Action | 进入执行线;一个或多个 Action 的参数。 | 全部完成后 FINISHED;失败走 FAILED。 | 靠近和开火放同一个节点持续 Update;装填放到后续节点。 |
| State | 进入执行线;配置 Enter、Update、Exit 事件图。 | 匹配事件或条件时离开,先执行 Exit。 | 在巡逻 State 中持续更新,收到 Alert 时切换。 |
| 事件监听 / Event Listener | 事件名;可开启全局监听。 | 收到匹配事件后走执行出口。 | 监听 Alert → 警戒 State。 |
| 发送事件 / Event Sender | 进入执行线;事件名和发送范围。 | 可配置继续执行或完成当前图。 | 向当前图发送 Reloaded。 |
| BDS 调用 / BDS call | 执行输入、BDS 配置引用。 | 选择并执行 Ability;结束后交回父流程。 | 入口 → Acquire;Acquire 的候选可直接调用 Combat 子 BDS。 |
| 子节点流 / Child Flow | 执行输入、子图引用、签名对应参数。 | 完成后继续执行;返回参数可接线或存变量。 | Target 与 Speed 传给 Approach;Result 写入当前图变量。 |
| 并行 / Parallel | 进入执行线;配置多个子图引用。 | 全部分支退出后继续。 | 移动与射击各用一条子图。 |
| 图退出事件 / Graph Exit | 内嵌清理动作或直接连接一个动作节点。 | 本图停止时自动触发。动作只执行 Enter 和 Exit。 | 清除 Global/IsFiring 或释放占用资源。 |
| 函数返回 / Return | 执行输入及返回定义对应的结果值。 | 结束当前调用,向调用方交付结果。 | Action FINISHED → Return;Result = 移动结果。 |
候选、评分与执行
| 节点 | 输入与配置 | 输出 / 完成 | 例子 |
|---|
| Ability | Bool 门槛;基础分;零个或多个加分 Context。 | 外层输出评分 Context;内部关联 Execution。 | 攻击门槛距离 ≤ 2000;基础分 10。 |
| Evaluation | 多个 Ability 的评分 Context。 | 每个候选对应的执行分支。 | 攻击 / 走近 / 跑近 → Evaluation → 各自 Execution。 |
| Execution | 选择一个或多个节点流;第一条可绑定入参及结果。 | 并行时等待所有子图结束;抢占时停止所有分支。 | 在同一个节点流执行配置中添加 Orbit 和射击子图。 |
| 条件加分 / Bonus | Bool 条件;Int 或相应数值分值。 | 加分 Context,接到 Ability 的加分口。 | 有掩体时 +20;普通 Int 变量接分值输入,非 Context 输出。 |
条件与逻辑
| 节点 | 输入与配置 | 输出 / 完成 | 例子 |
|---|
| 比较 / Compare | 同类型左值、右值;选择该类型允许的运算符。 | Bool。 | DistanceMm ≤ 2000 → 攻击门槛。 |
| 存在 / Exists | Actor 或支持存在判断的对象值。 | Bool。 | Target Actor → Exists → 候选门槛;不是数值大小比较。 |
| AND / OR / NOT | 多个 Bool 条件,或单个 Bool 取反。 | Bool。 | 距离 > 2000 AND 距离 ≤ 5000 → 走近。 |
数据来源与角色成员
| 节点 | 输入与配置 | 输出 / 完成 | 例子 |
|---|
| 常量 / Constant | 在节点内直接填写具体类型值。 | 所选类型值。 | 整数 2000 接整数比较;不要与米单位 Position.X 混用。 |
| 变量读取 / Variable read | 作用域与变量定义。 | 该变量的具体类型。 | 角色全局 CurrentEnemy : Actor → 属性节点角色输入。 |
| 自身 / 目标角色 | 当前 Agent 的角色或目标引用。 | Actor 引用,可以为空。 | 目标角色 → Exists;或目标角色 → Position。 |
| 属性读取 / Property | Actor 角色输入;角色类型与属性成员选择。 | 属性声明的类型;复合值可展开组件。 | Self → Health(Int);Target → Position(Vector3)。 |
| 方法查询 / Method query | 可暴露的查询方法及受支持参数。 | 方法声明的结果类型。 | 纯查询用于条件;会改变状态的方法放 Action 中调用。 |
基础数值与空间运算
| 节点 | 输入与配置 | 输出 / 完成 | 例子 |
|---|
| 加减乘除 / Add, Subtract, Multiply, Divide | 同类标量 A、B,可接线或直接填值。 | 相应 Int / Float。 | 伤害 = 攻击力 - 护甲;整数除法注意截断,除数不要为 0。 |
| 最小 / 最大值 / Min, Max | 同类标量 A、B。 | 相应 Int / Float。 | Min(当前血量 + 治疗, 最大血量)。 |
| 随机整数 / Random Integer | Int Min、Max;均可直接填写或接线。 | Int,包含上下限。 | 1–1000 的随机值 ≤ 350 表示千分之 350;不要接旧概率 Bool 节点。 |
| 向量加减 / Vector Add, Subtract | Vector3 A、B。 | Vector3。 | Target.Position - Self.Position 得到位移。 |
| 距离 / Distance | Vector3 A、B。 | Float,沿用输入坐标单位。 | 两个 Position(米)→ Distance(米);整数毫米规则优先读整数距离。 |
| 长度 / Length;点积 / Dot | 一个向量;或两个 Vector3。 | Float。 | Length(位移);Dot(归一化方向, 前向) 判断朝向关系。 |
| 归一化 / Normalize;取 X/Y/Z | Vector3。 | Normalize 输出 Vector3;组件输出 Float。 | 位移 → Normalize;Position 展开 XYZ 可省略独立取组件节点。 |
配置示例见图退出事件与清理和让多个子图并行运行。
常用 Action 怎么选
| 操作 | 配置要点 | 结束语义 |
|---|
| 设置角色属性 | 选 Actor 来源、可写属性和同类型值。 | 一次修改完成后结束。 |
| 调用角色方法 | 从方法列表选择,绑定各入参;不要猜字符串。 | 依据 Action / 方法的约定完成,不把任意长行为当瞬时查询。 |
| 设置变量 | 选当前图 / 角色全局、变量、同类型值。 | 写入后结束。 |
| 等待 | 选时间单位与时长;确定性规则使用整数逻辑时间。 | 到期 Finish。 |
| 角色移动 / 攻击 | 目标、范围、速度、伤害 / 间隔;持续行为按条件结束。 | 未完成的持续 Action Update;被打断时 Exit。 |
方法参数与返回值接线
在 Action 中选择具体的角色方法后,节点按方法签名生成带类型的入参针脚;非 void 的受支持返回值生成结果输出。入口参数、变量读取、子节点流入参和返回值共用 FlowDataPort 契约。拖动变量卡片的名称可以创建读取节点并接到匹配的输入;重新接线替换旧连接,旧节点保留。断线后恢复检查器中的默认值。