游戏 AI / 系统课时
把 EQS 结果写入 Blackboard
把 EQS 结果写入 Blackboard
本课把已经设计好的 EQS 战术选点查询接入行为树:敌人发现目标后执行查询,选出可用位置写入 Blackboard,再由 Move To 前往该位置。完成后,你能区分“查到了点”“写入成功”和“实际走得到”三个独立环节。
学习目标
- 配置 Run EQS Query 将最高评分的位置写入 Vector 类型黑板键。
- 用 Sequence 串联查询、写入和移动,并正确处理无结果分支。
- 在运行时验证 Blackboard 值与 Move To 的执行状态。
准备查询和黑板键
先在关卡中放置敌人 Pawn、可被其 AIController 占有的控制器、Nav Mesh Bounds Volume,以及可供搜索的地面。确保控制器启动使用目标 Blackboard 的行为树,并且现有 EQS 资产能产生用于移动的位置项。例如使用 EQS_FindTacticalPoint:Generator 在敌人周围生成候选点,Distance、Trace 或 Pathfinding Test 对其筛选和评分。
在 Blackboard 中准备两个键:TargetActor 为 Object,Base Class 设为 Actor;TacticalLocation 为 Vector。前者表示要接近或观察的对象,后者专门保存这次选出的移动终点。不要把坐标塞进 TargetActor,也不要让位置查询的结果写入 Actor 类型的键。
配置行为树的查询与移动
在追击或战术移动分支中创建一个 Sequence,并按顺序加入以下节点:
- 为 Sequence 设置 Blackboard Decorator:
TargetActor需为 Is Set,避免没有目标时反复选点。 - 添加
Run EQS QueryTask;Query Template选EQS_FindTacticalPoint,Run Mode选Single Best Item,Blackboard Key选TacticalLocation。 - 启用
Update BB on Fail(若当前版本提供该选项),查询失败时清除旧结果,避免继续使用过期位置。 - 后接
Move ToTask,Blackboard Key同样选择TacticalLocation;按角色体积设置合适的Acceptable Radius,例如从 80 cm 开始调试。

Run EQS Query 的职责是执行查询并把选中项写入所选黑板键;Move To 只读取该键并启动导航。查询成功不等于移动成功:位置可能后来被障碍堵住,导航代理也可能与生成点的条件不一致。Sequence 中前一任务失败时不会继续执行下一任务,外层 Selector 可再选择巡逻或等待分支。
验证写入与运行结果
启动 PIE,选中正在执行行为树的敌人。在 Behavior Tree 调试视图中确认 Run EQS Query 被执行;成功后观察 TacticalLocation 从未设置变成实际坐标,再检查 Move To 是否开始移动并最终成功。按 ' 打开 AI 调试器,使用小键盘 3 可查看 EQS 候选与赢家;若没有出现可选点,应先检查查询而非调大移动速度。
如果项目使用 C++,下面的片段示例可以放入已有模块的 .cpp,在取得敌人 AAIController* 后调用以确认结果是否已写入。项目的模块依赖需包含 AIModule;这段代码只做诊断,写入仍由内置 Task 完成。
#include "AIController.h"
#include "BehaviorTree/BlackboardComponent.h"
void LogEQSLocationState(AAIController* Controller)
{
if (!IsValid(Controller)) return;
const UBlackboardComponent* BB = Controller->GetBlackboardComponent();
if (!IsValid(BB)) return;
// 先验证 Vector 键已设置,而非把未设置值当作原点。
const FName Key(TEXT("TacticalLocation"));
const FBlackboard::FKey KeyId = BB->GetKeyID(Key);
const bool bReady = BB->IsVectorValueSet(KeyId);
UE_LOG(LogTemp, Display, TEXT("TacticalLocation ready=%s"),
bReady ? TEXT("true") : TEXT("false"));
}预期结果:在成功查询并写入后,Output Log 包含以下消息;若查询没有写入,末尾应为 false。
LogTemp: Display: TacticalLocation ready=true何时重新查询
Run EQS Query Task 通常在行为树再次走到该节点时重新执行,并不会因为目标移动而自动不断重算。目标位置或战场掩体持续变化时,可以在合适的分支重入时重新查询,或使用 Run EQS Service 定时更新键值;不要每帧对大量敌人同时运行高成本查询。
验收时分别制造正常候选点、全部被过滤、终点被阻挡三种情况:正常时写入并移动;无结果时不沿用旧坐标;导航受阻时由移动失败逻辑处理。