游戏 AI / 系统课时

配置 AI Sight 感知

配置 AI Sight 感知

本课让敌人通过 UE5 的 AI Sight 发现测试玩家,并在目标离开视野或被障碍物遮挡时收到感知变化。你将完成监听器、刺激源、视野参数和调试验证,最终能区分“没有检测到”和“行为树没有响应”这两类问题。

学习目标

  • 在 AIController 上配置视觉监听器,并为玩家注册 Sight 刺激源。
  • 理解发现范围、丢失范围、视野半角与阵营过滤的作用。
  • 使用 AI 调试视图及事件日志验证发现和丢失目标。

准备敌人与玩家

创建敌人 Character 和继承自 AIController 的 BP_SightTestController。在敌人 Character 的类默认值中,将 AI Controller Class 设为该控制器,并将 Auto Possess AI 设为 Placed in World or Spawned。运行时控制器必须实际占有敌人 Pawn,感知组件才能作为该 AI 的监听器工作。

在玩家 Character 上添加 AI Perception Stimuli Source 组件,开启 Auto Register as Source,在 Register as Source for Senses 中加入 AISense_Sight。某些项目会自动把 Pawn 注册为视觉刺激源,但显式注册能减少项目配置差异。

设置视野和过滤条件

在 BP_SightTestController 的 Components 面板添加 AI Perception,选中组件,在 Details 的 Senses Config 中新增 AI Sight,将 Dominant Sense 设为 AISense_Sight。以以下参数建立可复现的测试:

参数 示例值 作用
Sight Radius 1500 cm 尚未发现目标时的检测距离
Lose Sight Radius 1800 cm 已发现目标后允许的更远距离
Peripheral Vision Half Angle Degrees 60° 以 AI 前向为中心,左右各 60°
Detection by Affiliation Detect Neutrals 开启 允许检测未定义阵营的玩家
Max Age 2 s 刺激记录可保留的时间,不是固定的丢失延迟

Lose Sight Radius 通常大于 Sight Radius,可减少目标在边界附近移动时反复切换。只有距离满足条件并通过视角、遮挡和阵营判断,才可能触发成功感知;启用中立检测并不等于自动过滤出“玩家”,之后仍要按目标身份筛选。

AI Sight 发现范围、丢失范围与遮挡关系

用 C++ 验证事件

蓝图配置已经足够运行;以下是二选一的 C++ 等价方案,不要在同一控制器上重复创建第二个感知监听器。适用于已创建 C++ 类的 UE5 项目,项目模块的 .Build.cs 须包含 AIModule 依赖。分别创建下面两个文件,并将敌人的 AI Controller Class 改为该 C++ 类或其蓝图子类;玩家仍使用前面的刺激源设置。

SightTestController.h:

cpp
#pragma once
#include "CoreMinimal.h"
#include "AIController.h"
#include "Perception/AIPerceptionTypes.h"
#include "SightTestController.generated.h"

class UAIPerceptionComponent;
class UAISenseConfig_Sight;

UCLASS()
class ASightTestController : public AAIController
{
    GENERATED_BODY()
public:
    ASightTestController();

private:
    UPROPERTY(VisibleAnywhere)
    TObjectPtr<UAIPerceptionComponent> Listener;

    // 参数对象应与感知监听器保持相同生命周期。
    UPROPERTY()
    TObjectPtr<UAISenseConfig_Sight> SightConfig;

    // 动态事件的处理函数必须由 UFUNCTION 声明。
    UFUNCTION()
    void OnSightUpdated(AActor* Actor, FAIStimulus Stimulus);
};

SightTestController.cpp:

cpp
#include "SightTestController.h"
#include "Perception/AIPerceptionComponent.h"
#include "Perception/AISense.h"
#include "Perception/AISense_Sight.h"
#include "Perception/AISenseConfig_Sight.h"

ASightTestController::ASightTestController()
{
    Listener = CreateDefaultSubobject<UAIPerceptionComponent>(TEXT("SightListener"));
    SightConfig = CreateDefaultSubobject<UAISenseConfig_Sight>(TEXT("SightConfig"));

    // 发现与丢失半径分开设置,减少距离边界的反复触发。
    SightConfig->SightRadius = 1500.0f;
    SightConfig->LoseSightRadius = 1800.0f;
    SightConfig->PeripheralVisionAngleDegrees = 60.0f;
    SightConfig->SetMaxAge(2.0f);
    SightConfig->DetectionByAffiliation.bDetectNeutrals = true;
    SightConfig->DetectionByAffiliation.bDetectEnemies = true;
    SightConfig->DetectionByAffiliation.bDetectFriendlies = true;

    Listener->ConfigureSense(*SightConfig);
    Listener->SetDominantSense(UAISense_Sight::StaticClass());
    SetPerceptionComponent(*Listener);
    // 只订阅感知状态变化,不在 Tick 中轮询玩家位置。
    Listener->OnTargetPerceptionUpdated.AddDynamic(
        this, &ASightTestController::OnSightUpdated);
}

void ASightTestController::OnSightUpdated(AActor* Actor, FAIStimulus Stimulus)
{
    // 只记录有效 Actor 的视觉事件,排除其他感知类型。
    if (!IsValid(Actor) ||
        Stimulus.Type != UAISense::GetSenseID<UAISense_Sight>())
    {
        return;
    }

    const TCHAR* State = Stimulus.WasSuccessfullySensed()
        ? TEXT("seen") : TEXT("lost");
    UE_LOG(LogTemp, Warning, TEXT("Sight %s: %s"),
        State, *GetNameSafe(Actor));
}

预期输出(进入视野、再离开视野时分别出现;实例名称中的 <ID> 为动态标识):

text
LogTemp: Warning: Sight seen: BP_Player_C_<ID>
LogTemp: Warning: Sight lost: BP_Player_C_<ID>

在 PIE 中验证并排错

运行 PIE,面向敌人按 ' 打开 AI Debugger,再用小键盘 4 打开 Perception 分类。将玩家置于 AI 前方约 1000 cm,观察视觉调试信息;重新开始测试并从敌人背后接近,或在两者之间放置会阻挡视觉射线的墙,比较结果。C++ 方案还可以在 Output Log 中查看上述事件。

没有感知结果时,按“敌人是否被正确 Possess → 玩家是否注册 AISense_Sight → Detect Neutrals 是否开启 → 是否位于视野内 → 障碍物是否遮挡”的顺序排查。Max Age 并不是每隔两秒重新发现玩家的定时器,目标持续可见时不应期待事件每帧重复触发。

本阶段只验证感知系统是否正确提供目标变化;追击、搜索或待机需要后续决策逻辑读取这些事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 AI Sight 感知

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

登录哪都通