游戏 AI / 系统课时
设计目标与位置键
设计目标与位置键
敌人追击的是会移动的 Actor,搜索的是记录下来的位置,巡逻又需要独立的目的地。如果把这些信息混在同一个 Blackboard Key 中,行为树就容易追错目标或使用过期坐标。本课建立三个职责清晰的键,并验证它们如何支持追击、搜索和巡逻。
学习目标
- 区分 Actor 引用和世界位置,选择正确的 Blackboard Key 类型。
- 创建目标、移动位置与巡逻点三个键,并绑定到行为树。
- 理解键值的写入、清除与运行时验证方法。
按数据语义设计 Blackboard Key
假设敌人需要完成发现玩家、追击玩家、丢失目标后前往最后位置,以及恢复巡逻四种行为。推荐使用以下 Blackboard Key:
| Key 名称 | 类型 | 职责 |
|---|---|---|
TargetActor |
Object,Base Class 为 Actor |
保存当前可追踪的目标 Actor |
MoveLocation |
Vector |
保存最后已知目标位置或一次性移动目的地 |
PatrolPoint |
Vector |
保存巡逻系统选择的可达位置 |
Object 键保存对象引用。对于会移动的玩家,行为树的 Move To 可以直接使用 TargetActor,由移动逻辑跟踪目标 Actor 的位置。
Vector 保存一个世界空间坐标。即使原来的 Actor 后来移动,已经保存的 MoveLocation 也不会自动更新。因此它更适合记录最后已知位置、调查地点或固定移动目的地。
PatrolPoint 虽然也是 Vector,却不应该与搜索位置共用。这样才能防止目标感知逻辑覆盖巡逻路径,或巡逻选点任务清除正在使用的搜索目的地。

在编辑器创建并绑定键
- 打开 Content Drawer,通过 Add → Artificial Intelligence → Blackboard 创建资产,命名为
BB_Enemy。 - 双击打开 Blackboard,点击 New Key,选择
Object。 - 选中新建键,在 Blackboard Details 中将 Entry Name 设置为
TargetActor,将 Base Class 设置为Actor。 - 继续创建两个
Vector类型的键,命名为MoveLocation和PatrolPoint。 - 保存
BB_Enemy,打开BT_Enemy,选择根节点,在 Details 中将Blackboard Asset设置为BB_Enemy。 - 为不同的
Move To任务选择对应 Key,并根据行为优先级配置 Blackboard Decorator。
追击分支可以设置 TargetActor 的 Is Set 条件;搜索分支要求目标引用已清除,而 MoveLocation 仍有效;巡逻分支则使用 PatrolPoint。
当键值需要触发立即切换时,还应检查 Decorator 的 Observer Aborts 配置,否则高优先级条件变化后,当前低优先级任务可能不会立即中断。

在运行时写入目标和位置
在 Unreal C++ 中,可以通过 UBlackboardComponent 写入 Blackboard Key。下面是片段示例:将函数放入已配置 AIModule 依赖的 Unreal 游戏模块,在 AIController 初始化 Blackboard 之后,由感知事件或目标更新逻辑调用。它依赖有效的 Blackboard 组件,并非独立控制台程序。
#include "CoreMinimal.h"
#include "BehaviorTree/BlackboardComponent.h"
#include "GameFramework/Actor.h"
void UpdatePerceivedTarget(UBlackboardComponent* BB, AActor* Target)
{
if (!IsValid(BB)) return;
if (IsValid(Target))
{
// 保存可跟踪的对象引用和本次观测的位置快照。
BB->SetValueAsObject(TEXT("TargetActor"), Target);
BB->SetValueAsVector(TEXT("MoveLocation"), Target->GetActorLocation());
}
else
{
// 丢失目标后保留最后已知位置,供搜索分支使用。
BB->ClearValue(TEXT("TargetActor"));
}
}预期生效行为:检测到有效目标时,TargetActor 保存该 Actor,MoveLocation 保存当时的位置。目标丢失时,TargetActor 被清除,MoveLocation 暂时保留,从而允许敌人前往最后已知位置搜索。
PatrolPoint 应由巡逻任务独立计算,例如通过导航系统选择一个可达点后写入,而不是直接使用目标位置。搜索结束或位置失效时,应调用 ClearValue 清除 MoveLocation,防止敌人反复搜索旧坐标。
验证键值是否驱动正确行为
启动 PIE,开启 AI Debugging 并选择敌人,查看 Behavior Tree 类别下的 Blackboard 实时值。按照以下场景进行测试:
- 敌人发现玩家:
TargetActor指向玩家,MoveLocation记录最新观测坐标,追击分支满足条件。 - 玩家脱离感知:清除
TargetActor,保留MoveLocation,敌人进入最后已知位置的搜索分支。 - 搜索完成:清除
MoveLocation,行为树返回使用PatrolPoint的巡逻分支。 - 玩家重新出现:再次写入
TargetActor,根据分支优先级与中断设置恢复追击。
如果 Move To 没有成功执行,还要检查所选 Blackboard Key 的类型、目标是否有效,以及导航网格是否覆盖目的地。键值正确只证明数据传递符合预期,并不能保证移动路径一定可达。
三个键的职责应始终保持稳定:TargetActor 回答追踪哪个对象,MoveLocation 回答前往哪个已知位置,PatrolPoint 回答无目标时在哪里巡逻。清晰的数据边界能减少任务之间的意外覆盖,也便于后续扩展感知和决策逻辑。