游戏 AI / 系统课时

处理键值为空的分支

处理键值为空的分支

敌人可能尚未初始化 Blackboard,目标 Actor 可能已经销毁,搜索位置也可能从未写入。如果把这些值直接交给移动任务,就容易出现空引用、反复失败或错误追逐。本课为三类缺失数据设置守卫和回退,使 AI 能稳定进入安全分支。

学习目标

  • 区分对象无效、Vector 未设置与 Blackboard 尚未就绪。
  • 在 AI Controller 和行为树任务中阻断不安全的读取。
  • 用空值、销毁目标和不可达位置验证回退路径。

给空值明确的语义

在 BB_Enemy 中准备 TargetActor(Object,Base Class 为 Actor)、LastKnownLocation(Vector)与 bAIReady(Bool)。本例的约定是:TargetActor 未设置表示没有可追逐目标;LastKnownLocation 未设置表示没有搜索地点;bAIReady = false 表示控制器尚未完成准备。

不要把向量 (0, 0, 0) 当作无效位置,世界原点可能是合法目标。读取位置之前,使用 Blackboard Component 的 Is Vector Value Set 检查键是否已经赋值且未被清除;它不负责判断该地点能否通过导航到达。对于对象键,在访问 Actor 的位置、组件或状态前仍需经过 Is Valid 检查。

先初始化再允许决策

在 BP_EnemyAIController 的 On Possess 事件中,使用 Use Blackboard 指定 BB_Enemy,确认返回成功后才能使用返回的 Blackboard Component。先将 bAIReady 写为 false,清空目标及旧搜索位置,再执行 Run Behavior Tree(BT_Enemy);只有启动成功才将 bAIReady 写为 true。初始化失败时记录错误,不要继续写空组件或启动依赖该黑板的树。

下面是 Blueprint 节点顺序的片段示例,依赖已创建的两个资产,不是可独立运行的脚本。

text
# 初始化失败时不继续访问 Blackboard Component
On Possess(Pawn) -> Use Blackboard(BB_Enemy) -> Branch(Return Value)
false -> Print String("Blackboard 初始化失败")
true  -> Set Value as Bool("bAIReady", false)
      -> Clear Value("TargetActor")
      -> Clear Value("LastKnownLocation")
      -> Run Behavior Tree(BT_Enemy) -> Branch(Return Value)
      -> 启动成功时 Set Value as Bool("bAIReady", true)
      -> 启动失败时 Print String("行为树启动失败")

这里的两个 Return Value 分别来自 Use Blackboard 与 Run Behavior Tree,不能混接。只有成功分支能更新完成标记;重新占有 Pawn 时也应重新执行清理,避免上一个角色的键值进入新一轮决策。

在读取点设置安全回退

根 Selector 从左到右安排 Chase、Search、Idle。Chase 要求 bAIReady 为真且 TargetActor 为 Is Set;Search 要求 bAIReady 为真且 LastKnownLocation 为 Is Set;最后的 Idle 使用 Wait,不读取对象或位置。前两条分支的 Blackboard Decorator 可将 Observer Aborts 设为 Both,让清键立即触发重新选择。

仅有 Decorator 仍不够:目标可能在条件通过后、任务使用前被销毁。因此在自定义追逐 Task 中先读取目标,再用 Is Valid 检验;失败时清除 TargetActor 并以失败结束任务,交回 Selector 选择搜索或待机。搜索任务使用位置前也检查 Is Vector Value Set,失败就清理该键并返回失败。不要对无效对象调用 GetActorLocation。

Blackboard 缺失键值的安全回退流程

复现异常并核对结果

在 PIE 中打开行为树调试,选中敌人实例;通过控制器蓝图的测试事件临时写入或清空指定键,再逐项检查:

测试输入 预期结果
bAIReady = false Chase 和 Search 均不可进入,执行 Idle;若黑板初始化已失败则不启动树
TargetActor 被清空且位置未设置 不调用目标相关逻辑,进入 Idle
目标 Actor 已销毁 使用前判为无效,清目标键,再选择 Search 或 Idle
位置已写为 (0, 0, 0) 视为已设置位置,不因坐标为零而跳过
搜索位置在 NavMesh 外 可能出现 Move To 失败,不能误认为它是空值

最后一项需要单独处理可达性:先确认位置落在导航范围内;若使用自定义移动任务,在移动失败回调中清除 LastKnownLocation,再回到保底分支。不要假定内置 Move To 失败后会自动清键。稳定的 AI 不应依赖所有信息永远有效,而应让每个读取点都有可验证的失败路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理键值为空的分支

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

登录哪都通