游戏 AI / 系统课时
选择 Task 的职责边界
选择 Task 的职责边界
当一个 Task 同时寻路、造成伤害、播放动画并修改 Blackboard 时,行为树会很难中断,也难以复用。本篇把 Task 定义为清晰的动作请求与完成结果,并用一个 UE5 C++ 节点展示如何只做一件事。
学习目标
- 区分 Task、Decorator、Service 与游戏业务组件的职责。
- 为移动、攻击、动画和状态更新选择合适的执行位置。
- 根据同步完成、异步等待和中断清理设计 Task 的返回结果。
先按责任而不是功能名称拆分
Task 是行为树的叶节点,负责发起一个具体动作,并报告结果;它不应成为整个敌人角色的业务控制器。条件是否允许执行交给 Decorator,持续观察或更新 Blackboard 的工作通常交给感知系统、AIController 或 Service。
| 需求 | 推荐实现位置 | Task 的边界 |
|---|---|---|
| 移动到目标 | 内置 Move To 与寻路系统 |
读取目标键,等待到达或失败,响应中断 |
| 发动攻击 | 战斗组件或技能系统 | 校验目标、发起请求、等待完成通知 |
| 播放攻击动画 | 战斗逻辑触发 Montage,动画系统负责表现 | 不直接裁定命中和伤害 |
| 更新是否看见目标 | 感知回调、AIController 或 Service 写入 Blackboard | 读取决策输入,不重复感知 |
简单的一次性动画可以使用内置 Play Animation Task;但涉及攻击判定、连招、受击打断时,动画只是战斗流程的一部分,不宜让播放动画的 Task 同时承担伤害结算。
让数据和动作沿单向路径流动
以“看到玩家后攻击”为例:感知层更新 TargetActor 和可见性;Blackboard Decorator 判断能否进入攻击分支;Task 请求战斗组件执行攻击;战斗组件管理冷却、动画和命中;完成通知返回 Task,再由 Task 向行为树报告结果。

一个实用判断是:移除行为树后,这段业务逻辑是否仍有存在价值? 如果攻击冷却、伤害计算和 Montage 播放仍然需要,它们就应该留在战斗系统;Task 只是调用入口和接收结果。
实现一个只负责设置焦点的 Task
下面的项目片段示例用于 UE5 C++ 游戏模块,依赖 AIModule,需要在模块的 .Build.cs 中声明该依赖;它不能脱离 Unreal 项目单独运行。假设 BB_Enemy 有 TargetActor(Object,Base Class 为 Actor),并由 AIController 运行行为树。
创建 BTTask_FocusTarget.h,基于 UBTTask_BlackboardBase 获取编辑器可选的 Blackboard Key:
#pragma once
#include "CoreMinimal.h"
#include "BehaviorTree/Tasks/BTTask_BlackboardBase.h"
#include "BTTask_FocusTarget.generated.h"
UCLASS()
class UBTTask_FocusTarget : public UBTTask_BlackboardBase
{
GENERATED_BODY()
public:
UBTTask_FocusTarget();
protected:
virtual EBTNodeResult::Type ExecuteTask(
UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory) override;
};创建 BTTask_FocusTarget.cpp,只读取目标并向 AIController 下达设置焦点的即时命令:
#include "BTTask_FocusTarget.h"
#include "AIController.h"
#include "BehaviorTree/BehaviorTreeComponent.h"
#include "BehaviorTree/BlackboardComponent.h"
#include "GameFramework/Actor.h"
UBTTask_FocusTarget::UBTTask_FocusTarget()
{
NodeName = TEXT("Focus Target");
// 限定键类型,避免误选 Vector 或 Bool。
BlackboardKey.AddObjectFilter(
this, GET_MEMBER_NAME_CHECKED(UBTTask_FocusTarget, BlackboardKey),
AActor::StaticClass());
}
EBTNodeResult::Type UBTTask_FocusTarget::ExecuteTask(
UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory)
{
AAIController* AI = OwnerComp.GetAIOwner();
UBlackboardComponent* BB = OwnerComp.GetBlackboardComponent();
if (!IsValid(AI) || !IsValid(BB)) return EBTNodeResult::Failed;
AActor* Target = Cast<AActor>(
BB->GetValueAsObject(BlackboardKey.SelectedKeyName));
if (!IsValid(Target)) return EBTNodeResult::Failed;
// 只设置控制器焦点,不承担转身动画或伤害处理。
AI->SetFocus(Target);
return EBTNodeResult::Succeeded;
}预期结果:编译后在行为树中选择该 Task 的 Blackboard Key 为 TargetActor。目标有效时节点返回 Succeeded,AIController 的焦点指向目标;目标为空时返回 Failed。SetFocus 不保证 Pawn 必然立即旋转,旋转仍取决于角色和控制器设置,也不会因 Task 成功而自动清除焦点。
异步攻击与中断必须成对设计
上例属于瞬时命令,可以直接返回 Succeeded 或 Failed。攻击、等待动画或其他耗时动作则不同:Task 发出请求后,只有在操作确实结束时才能算成功。C++ 的 ExecuteTask 可返回 InProgress,待战斗组件报告完成再调用 FinishLatentTask;请求被拒绝则返回 Failed;这些返回约定见 Epic UBTTaskNode API。
当 Decorator 中断攻击分支时,还要撤销这个 Task 注册的完成回调,并根据业务规则取消对应攻击,防止旧回调在新目标出现后误结束另一轮执行。默认 C++ Behavior Tree 节点实例可能被多个 AI 共享;不要直接把每个 AI 的运行时句柄放在共享节点成员中,应使用节点内存或明确启用节点实例化。
用三种结果检查边界
在 PIE 中依次检查:TargetActor 为空时 Task 失败且不触发攻击;目标有效时 Move To 先处理导航结果,再由攻击 Task 请求战斗组件;攻击进行中目标失效时,原分支能中断且不再触发过期完成回调。
如果一个 Task 里仍然包含目标搜索、移动路径、伤害结算和动画控制,应继续拆到感知、移动、战斗与表现层。理想的 Task 只需要回答三个问题:要请求什么动作、何时完成、被打断后清理什么。