游戏 AI / 系统课时
区分状态键与目标键
区分状态键与目标键
本节把 AI 的“看见了什么”“当前要追谁”和“接下来执行哪种行为”拆成独立 Blackboard Key。你将建立一套包含追逐、调查和巡逻的最小数据契约,避免感知丢失后仍追逐旧对象,或因复用单一变量导致分支含义混乱。
学习目标
- 按感知事实、目标引用、记忆位置和行为模式划分 Key。
- 用明确的写入规则处理发现、丢失目标和调查结束。
- 让行为树只消费符合类型与语义的 Blackboard 值。
用不同 Key 表达不同问题
在 BB_Guard 中建立以下键,名字、类型与用途保持一致:
| Key | 类型 | 唯一职责 | 典型消费者 |
|---|---|---|---|
HasLineOfSight |
Bool | 当前是否仍能看见有效目标 | 需要视线的攻击条件 |
TargetActor |
Object,Actor | 当前可直接追逐的对象引用 | Chase 的 Move To |
LastKnownLocation |
Vector | 最后一次确实看到目标的位置 | Investigate 的 Move To |
BehaviorMode |
Enum | 当前策略:Patrol、Investigate、Chase | Selector 的分支条件 |
HasLineOfSight = false 不等于“从未发现过敌人”;此时 TargetActor 可以清空,但 LastKnownLocation 仍可能保留可供调查的位置。BehaviorMode 表示决策结果,不应由动画状态或任意 Task 随意覆盖。若只有巡逻和追逐两种行为,模式键可能是多余的;引入调查等独立策略时才更有价值。

约定状态转换与写入所有权
建议由 AIController 或统一的感知适配层集中更新这些键,行为树 Decorator 和 Task 只读取状态;只有“调查完成”之类的明确业务事件才反向请求状态更新。
- 首次看见目标:
HasLineOfSight = true,TargetActor指向该 Actor,刷新LastKnownLocation,模式改为Chase。 - 失去视线:设视线状态为
false,清空TargetActor;保留最后可见位置,模式改为Investigate。不要用不可见目标当前的位置冒充“最后看见的位置”。 - 调查到达终点且未再次发现目标:清空
LastKnownLocation,模式改为Patrol。 - 从未有过有效位置:无目标时直接
Patrol,不进入无目的地的调查分支。
这里的“清空”应使用 ClearValue,不能把世界原点 (0,0,0) 当成“没有位置”。在多目标游戏中,还应先做目标筛选,避免其他 Actor 的感知丢失事件清掉当前目标。
在 AIController 中实现状态契约
以下为可编译进 UE5 游戏模块的完整控制器类。需要在 .Build.cs 声明 AIModule 依赖,在 BB_Guard 中将 BehaviorMode 的 Enum Type 指定为 C++ 枚举 EGuardMode;TargetActor 为基类 Actor 的 Object Key,其余键按表创建。将一个基于该类的 AIController 蓝图指定给 AI Pawn,并在默认属性中配置 BehaviorTreeAsset。
GuardAIController.h:
#pragma once
#include "CoreMinimal.h"
#include "AIController.h"
#include "GuardAIController.generated.h"
class UBehaviorTree;
UENUM(BlueprintType)
enum class EGuardMode : uint8
{
Patrol,
Investigate,
Chase
};
UCLASS()
class AGuardAIController : public AAIController
{
GENERATED_BODY()
public:
UPROPERTY(EditDefaultsOnly, Category = "AI")
TObjectPtr<UBehaviorTree> BehaviorTreeAsset;
UFUNCTION(BlueprintCallable, Category = "AI")
void UpdateSight(AActor* Candidate, bool bVisible);
UFUNCTION(BlueprintCallable, Category = "AI")
void FinishInvestigation();
protected:
virtual void OnPossess(APawn* InPawn) override;
};GuardAIController.cpp:
#include "GuardAIController.h"
#include "BehaviorTree/BehaviorTree.h"
#include "BehaviorTree/BlackboardComponent.h"
#include "GameFramework/Actor.h"
void AGuardAIController::OnPossess(APawn* InPawn)
{
Super::OnPossess(InPawn);
if (BehaviorTreeAsset && RunBehaviorTree(BehaviorTreeAsset.Get()))
{
GetBlackboardComponent()->SetValueAsEnum(
TEXT("BehaviorMode"), static_cast<uint8>(EGuardMode::Patrol));
}
}
void AGuardAIController::UpdateSight(AActor* Candidate, bool bVisible)
{
UBlackboardComponent* BB = GetBlackboardComponent();
if (!BB) return;
// 此接口假设传入的 Candidate 已经过玩家身份和目标所有权筛选。
const bool bSeen = bVisible && IsValid(Candidate);
BB->SetValueAsBool(TEXT("HasLineOfSight"), bSeen);
if (bSeen)
{
BB->SetValueAsObject(TEXT("TargetActor"), Candidate);
BB->SetValueAsVector(TEXT("LastKnownLocation"), Candidate->GetActorLocation());
BB->SetValueAsEnum(TEXT("BehaviorMode"),
static_cast<uint8>(EGuardMode::Chase));
}
else
{
// 目标不可见后只保留先前写下的位置,不再读取其当前位置。
BB->ClearValue(TEXT("TargetActor"));
const bool bHasMemory = BB->IsVectorValueSet(
BB->GetKeyID(TEXT("LastKnownLocation")));
BB->SetValueAsEnum(TEXT("BehaviorMode"),
static_cast<uint8>(bHasMemory ? EGuardMode::Investigate
: EGuardMode::Patrol));
}
}
void AGuardAIController::FinishInvestigation()
{
UBlackboardComponent* BB = GetBlackboardComponent();
if (!BB || BB->GetValueAsEnum(TEXT("BehaviorMode"))
!= static_cast<uint8>(EGuardMode::Investigate)) return;
BB->ClearValue(TEXT("LastKnownLocation"));
BB->SetValueAsEnum(TEXT("BehaviorMode"),
static_cast<uint8>(EGuardMode::Patrol));
}把现有视觉感知回调中的有效玩家 Actor 与“是否成功感知”结果传入 UpdateSight;如目标移动,只在仍可看见目标时刷新最后可见位置。调查分支到达记录位置且未重新发现目标后调用 FinishInvestigation。此类不创建感知组件,需复用项目已有的感知事件源。
预期结果:在 PIE 中观察 BB_Guard 的运行时键值,可得到以下状态;Actor 名称和位置由场景决定。
| 事件 | HasLineOfSight | TargetActor | LastKnownLocation | BehaviorMode |
|---|---|---|---|---|
| 初始 | false | 空 | 未设置 | Patrol |
| 看见目标 | true | 有效 Actor | 可见位置 | Chase |
| 丢失目标 | false | 空 | 保留上次位置 | Investigate |
| 调查结束 | false | 空 | 未设置 | Patrol |
让行为树只判断自己需要的键
将 Selector 的优先级按 Chase、Investigate、Patrol 自左向右排列。Chase 分支应同时要求 BehaviorMode = Chase 和 TargetActor Is Set;Investigate 要求 BehaviorMode = Investigate 且 LastKnownLocation Is Set;Patrol 可作为兜底分支。各分支的 Move To 分别选 Actor Key 或 Vector Key,不要在任务中根据模式猜测同一键究竟装了什么。
对于高优先级条件,按需要设置 Blackboard Decorator 的 Observer Aborts,让新目标能打断巡逻,让失去目标能停止追逐。不要把 HasLineOfSight 直接当作目标引用,也不要将 BehaviorMode 当作不可更改的事实:它可能受弹药、距离、警戒等级和命令等多种规则影响。
验收时重点检查两条边界:失去视线后,追逐任务不再持有旧目标;进入调查时,仍能使用独立保存的最后可见位置。只有数据含义稳定,Behavior Tree 的分支条件才会长期可维护。