游戏 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 向行为树报告结果。

行为树 Task 与 Blackboard 及战斗组件的职责数据流

一个实用判断是:移除行为树后,这段业务逻辑是否仍有存在价值? 如果攻击冷却、伤害计算和 Montage 播放仍然需要,它们就应该留在战斗系统;Task 只是调用入口和接收结果。

实现一个只负责设置焦点的 Task

下面的项目片段示例用于 UE5 C++ 游戏模块,依赖 AIModule,需要在模块的 .Build.cs 中声明该依赖;它不能脱离 Unreal 项目单独运行。假设 BB_Enemy 有 TargetActor(Object,Base Class 为 Actor),并由 AIController 运行行为树。

创建 BTTask_FocusTarget.h,基于 UBTTask_BlackboardBase 获取编辑器可选的 Blackboard Key:

cpp
#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 下达设置焦点的即时命令:

cpp
#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 只需要回答三个问题:要请求什么动作、何时完成、被打断后清理什么。

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

目录与阅读设置

阅读设置

17

记录一个想法

选择 Task 的职责边界

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

登录哪都通