游戏 AI / 系统课时
看得见却没有感知事件
看得见却没有感知事件
角色明明出现在 NPC 面前,却没有任何感知回调时,不要先怀疑行为树。应从候选筛选开始,依次检查碰撞层、视线检测和事件分发,找到感知链上第一个没有产生预期结果的节点。
学习目标
- 区分画面可见与感知系统判定可见这两个不同概念
- 按固定顺序定位候选、碰撞层、LOS 和事件分发故障
- 为线上感知链增加可观察信号,避免只靠断点猜问题
先确认问题发生在哪一层
屏幕上能看到玩家,只能证明渲染系统成功绘制了对象,并不能证明 AI 感知链已经接纳它。一个常见的感知流程至少会经过候选筛选、碰撞层过滤、视线检测和事件分发四步,其中任何一步拒绝目标,后面的感知事件都不会出现。
因此排查时先记录一个具体目标的 targetId,不要一边换角色、一边改多个参数。然后沿同一个目标追踪各阶段是否通过。

按链路逐段定位
首先检查候选筛选。空间索引、感知半径、阵营过滤或对象激活状态都可能让目标根本没有进入候选集合。此时继续检查射线没有意义,因为 LOS 根本没有机会执行。最有价值的信号是本帧候选数量,以及目标是否出现在候选 ID 列表中。
候选存在后,再检查碰撞层。常见问题不是射线算法失效,而是目标所在层没有被查询掩码包含,或者障碍物与角色共用了不合适的层。线上日志至少应记录查询掩码和首个命中的碰撞体类型,而不是只打印一个 visible=false。
接着检查 LOS。射线首先命中墙体、透明阻挡物、角色自己的碰撞体或错误的触发器,都可能让视觉上无遮挡的目标被感知系统判定为不可见。这里要记录射线起点、目标点和首个命中对象,才能区分几何遮挡和配置错误。
最后检查事件分发。如果前面全部通过,但订阅者没有收到事件,就检查事件总线是否注册、对象销毁后是否重复解绑,以及事件是否被投递到了错误的 NPC 实例。此时最关键的不是“有没有回调日志”,而是同时记录“事件已产生”和“订阅者已消费”两个状态。
用最小诊断程序复现链路
下面用一个独立 C# 程序模拟四个阶段。它不依赖具体游戏引擎,目的不是实现真正的物理射线,而是验证排查顺序:只报告链路中最早出现的失败点。
using System;
public record Candidate(
string Name,
bool InRange,
bool LayerAllowed,
bool LosClear,
int SubscriberCount);
public static class Program
{
private static string Diagnose(Candidate candidate)
{
if (!candidate.InRange)
return $"{candidate.Name}: rejected by candidate filter";
if (!candidate.LayerAllowed)
return $"{candidate.Name}: rejected by collision layer";
if (!candidate.LosClear)
return $"{candidate.Name}: blocked by LOS";
if (candidate.SubscriberCount == 0)
return $"{candidate.Name}: event produced but no subscriber";
return $"{candidate.Name}: perception event delivered";
}
public static void Main()
{
var samples = new[]
{
new Candidate("Player-A", false, true, true, 1),
new Candidate("Player-B", true, false, true, 1),
new Candidate("Player-C", true, true, false, 1),
new Candidate("Player-D", true, true, true, 0),
new Candidate("Player-E", true, true, true, 1)
};
foreach (var sample in samples)
Console.WriteLine(Diagnose(sample));
}
}预期输出:
Player-A: rejected by candidate filter
Player-B: rejected by collision layer
Player-C: blocked by LOS
Player-D: event produced but no subscriber
Player-E: perception event delivered这个示例体现了线上排查最重要的原则:记录第一个失败阶段,而不是只记录最终是否感知成功。如果生产代码只有最终布尔值,就应先补充阶段性诊断信息,再处理复杂现场。
修复后验证完整闭环
修复完成后,不要只验证“NPC 终于追人了”。应分别验证目标进入候选集合、碰撞层通过、LOS 首个命中正确、事件被投递,以及感知记忆最终写入。这样才能确认不是其他逻辑刚好掩盖了原问题。
还需要测试至少三个边界场景:目标刚好位于感知半径边缘、目标被墙体短暂遮挡、目标销毁并重新生成。若这些场景仍能稳定产生或停止感知事件,才说明链路真正恢复正常。线上再遇到类似问题时,只要比较各阶段信号,就能迅速确定故障是在“没成为候选”“看不见”还是“事件没送到”。