游戏 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 只读取状态;只有“调查完成”之类的明确业务事件才反向请求状态更新。

  1. 首次看见目标:HasLineOfSight = true,TargetActor 指向该 Actor,刷新 LastKnownLocation,模式改为 Chase。
  2. 失去视线:设视线状态为 false,清空 TargetActor;保留最后可见位置,模式改为 Investigate。不要用不可见目标当前的位置冒充“最后看见的位置”。
  3. 调查到达终点且未再次发现目标:清空 LastKnownLocation,模式改为 Patrol。
  4. 从未有过有效位置:无目标时直接 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:

cpp
#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:

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 的分支条件才会长期可维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分状态键与目标键

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通