自动关联目录：感知系统

覆盖说明：官方 Gameplay Systems 正文点名 AI Perception Component 为 AI 系统之一；具体子页面无法枚举，本篇按引擎模块书写。

1. 定位

AI Perception 解决"NPC 知道什么"：谁在视野里、谁发出了声响、谁碰到了我。它是 AI 的唯一数据入口。

一句话定位：感知的结果应该写进黑板，决策逻辑从黑板读——不要让行为树直接去做射线检测，那样每个节点都在重复计算。

2. 结构：刺激（Stimulus）模型

刺激源（Stimuli Source）          感知者（AI Perception Component）
  玩家、噪音源、尸体                └─ 配置若干 Sense：
        │  注册                         ├─ Sight（视觉）
        │                               ├─ Hearing（听觉）
        ▼                               ├─ Damage（伤害）
  AIPerceptionStimuliSourceComponent    ├─ Touch（接触）
                                        └─ Team / Prediction（团队、预测）
                                             │
                                             ▼
                                      OnPerceptionUpdated 回调
                                             │
                                             ▼
                                        写入 Blackboard

3. 用法

// 感知者：配置视觉
UAIPerceptionComponent* Perception = CreateDefaultSubobject<UAIPerceptionComponent>(TEXT("Perception"));
SightConfig = CreateDefaultSubobject<UAISenseConfig_Sight>(TEXT("SightConfig"));
SightConfig->SightRadius = 2000.f;
SightConfig->LoseSightRadius = 2500.f;
SightConfig->PeripheralVisionAngleDegrees = 90.f;
SightConfig->DetectionByAffiliation.SetDetectEnemies(true);
Perception->ConfigureSense(*SightConfig);

// 回调
Perception->OnPerceptionUpdated.AddDynamic(this, &AMyAIController::OnPerceptionUpdated);

忘了给目标加 Stimuli Source 组件，是"AI 完全看不到玩家"的第一原因。

4. 各 Sense 的特点

视觉是最贵的——它要做实际的可见性检测。目标数量多时应限制 MaxActiveLoops 或降低更新频率。

5. 代价与权衡

6. 踩坑与排查

7. 排查顺序

1. 完全感知不到？→ 目标是否有 Stimuli Source + 注册了对应 Sense
2. 敌我不分？→ 团队 ID 与 Affiliation
3. 边界抖动？→ 迟滞参数
4. 慢？→ 视觉目标数与更新频率
5. 感知到但没反应？→ 是否写入黑板

8. 调试

参考

• 导航系统 · 行为树 · EQS
• 官方 Gameplay Systems 分类（AI Perception Component）