游戏 AI / 系统课时
完成最终行为回归验证
完成最终行为回归验证
行为树在单次追击中表现正常,不代表失去视野、重新发现或死亡打断也可靠。本课在固定测试地图中逐个触发六条关键路径,用 Blackboard、行为树执行节点和可复查日志确认状态迁移正确,避免只凭敌人看起来会移动就判定通过。
学习目标
- 为发现、追击、失去目标、搜索、重新发现、死亡建立可重复的测试步骤。
- 用 Gameplay Debugger 和自动断言区分感知错误、决策错误与移动错误。
- 检查事件先后顺序、死亡后的中断行为及回归交付条件。
准备可重放的测试环境
建立 L_AIRegression 测试地图,放置 Nav Mesh Bounds Volume 并生成可行走的 NavMesh,再放置一个可控制的玩家目标、一道能阻断 Sight 的墙和一名敌人。保持起点、遮挡物及寻路区域固定,临时关闭随机巡逻、其他 AI 干扰与不可控刷怪。
先用 PIE 校验敌人被正确的 AIController 占有,Behavior Tree 正在运行,初始 TargetActor 无效且 IsDead=false。每次用同一初始状态重新开局;分别在近战和远程敌人上重复验证,不能把其中一个敌种的通过结果代替另一个。
逐条验证状态转换
| 路径 | 触发动作 | 必须观察到的结果 |
|---|---|---|
| 发现目标 | 玩家走入可见范围 | CanSeeTarget=true,TargetActor 指向玩家 |
| 追击 | 玩家保持可见并移动 | 追击分支激活,Move To 持续更新有效目标 |
| 失去目标 | 玩家移动至墙后 | CanSeeTarget=false,记录最后可见位置 |
| 搜索 | 玩家继续保持隐藏 | 搜索最后已知位置;超过搜索期限后安全回巡逻 |
| 重新发现 | 搜索中再次暴露玩家 | 中断旧搜索并重新进入追击,不保留陈旧目标 |
| 死亡 | 对敌人施加致命伤害 | IsDead=true,不再追击、攻击或重新启动行为 |
这是一份项目约定的验收契约,不是引擎自动设置上述键。若丢失视野时清除 TargetActor,先写好 LastKnownLocation 与 HasLastKnownLocation=true;搜索结束再清除搜索标志。否则可能因为目标引用丢失而直接返回待机,或因向量默认零值错误跑向世界原点。

同时核对事件、黑板与执行节点
在 PIE 中打开 Gameplay Debugger(默认撇号键,具体按键以项目绑定为准),选中当前敌人,查看 Behavior Tree、Blackboard、Perception 与 NavMesh 信息。记录每次状态变化的实际键值、活跃 Task、是否有有效路径;单看 CanSeeTarget 变化不足以证明追击或搜索任务真的被中断。
推荐在对应的真实回调或状态入口用 Blueprint Print String 并开启 Print to Log,仅在发生迁移时输出一次 AI_REG[<ID>]=SIGHT、CHASE、LOST、SEARCH、REACQUIRED、DEAD。其中 <ID> 是单次测试的唯一标识,同一 AI 的所有记录应一致;不要在每帧 Tick 中刷这些事件。
将下面代码保存为 check_ai_regression.py,用 python check_ai_regression.py "<PATH>" "<ID>" 检查本次运行的实际日志;<PATH> 是该次 PIE 日志文件路径,实际值因项目和运行环境而不同。
import argparse
from pathlib import Path
parser = argparse.ArgumentParser()
parser.add_argument("log_path")
parser.add_argument("run_id")
args = parser.parse_args()
# 只读取同一次测试的事件,排除其他敌人和旧会话。
tag = f"AI_REG[{args.run_id}]="
observed = []
for line in Path(args.log_path).read_text(
encoding="utf-8", errors="replace"
).splitlines():
if tag in line:
observed.append(line.split(tag, 1)[1].split()[0])
# 允许额外诊断事件,但六个关键节点必须依次出现。
required = ("SIGHT", "CHASE", "LOST", "SEARCH", "REACQUIRED", "DEAD")
next_index = 0
for event in observed:
if next_index < len(required) and event == required[next_index]:
next_index += 1
if next_index != len(required):
raise SystemExit(f"FAIL: 仅按序匹配 {next_index}/6,记录={observed}")
# DEAD 之后不允许再发出存活行为事件。
death_index = observed.index("DEAD")
if any(e in {"SIGHT", "CHASE", "SEARCH", "REACQUIRED", "ATTACK"}
for e in observed[death_index + 1:]):
raise SystemExit("FAIL: 死亡后仍有活跃行为事件")
print("PASS: 6/6 关键事件按序出现,死亡后无新增活跃行为")预期输出(真实日志满足断言时):
PASS: 6/6 关键事件按序出现,死亡后无新增活跃行为这段脚本只验证已记录事件的顺序,不能单独证明事件由正确的行为节点触发。应与调试器中的当前 Task、Blackboard 值和角色实际停止运动的证据一起判定。
固化功能测试并处理失败
启用 Functional Testing 后,在测试地图放置 Functional Test Actor,或建立它的 Blueprint 子类。Prepare Test 重置角色、生命值和黑板;准备完毕后在 Start Test 驱动玩家进入视野、离开视野、重新进入以及触发死亡。各阶段使用 Assert True / Assert False 检查契约,全部成功才调用 Finish Test 标记成功,任一断言失败则标记失败并附原因。涉及等待寻路或感知更新时,应按条件等待并设置超时,不要假定下一帧必然完成。
失败时按证据层级定位:没有 Sight 事件先查感知与遮挡;有目标却没追击先查 Blackboard 与 Decorator 的观察中断;追击激活但原地不动再查 NavMesh 和 Move To;死亡后仍行动则检查移动请求、尚未结束的 Task 与战斗组件是否真正取消。修复后重跑全部六条路径,并额外覆盖搜索超时、死亡发生在搜索中、两名敌人同时出现的情况。
最终以两种敌人多次重复通过、无卡死或错误回跳、死亡后无新动作,以及日志和调试证据能够对应为验收标准;事件脚本显示 PASS 但游戏中仍有错误时,验收仍应判为失败。