游戏引擎 / 系统课时

处理触发器与区域事件

处理触发器与区域事件

这一课用一个可复用的 Trigger Actor 处理角色进入、离开和一次性机关触发。重点不是“碰到就执行代码”,而是把碰撞过滤、Overlap 事件和机关逻辑分开,这样区域事件才不会因为多余组件或重复进入而失控。

学习目标

  • 配置只参与查询的 Trigger 碰撞体并接收 Begin/End Overlap
  • 对进入对象做过滤,避免无关 Actor 触发机关
  • 实现可重复区域与一次性区域,并能定位重复触发或完全不触发的问题

把触发区域当作传感器

Trigger 最适合承担“谁进入了某个空间”的感知职责,而不是直接充当实体墙。一个常用配置是让 UBoxComponent 使用 QueryOnly,忽略所有通道,只把 Pawn 设置为 Overlap,并开启 Generate Overlap Events。这样玩家可以穿过区域,但进入和离开边界时会产生事件。

Trigger区域的进入离开事件链路

触发事件能否产生取决于两边的碰撞设置。Trigger 自己开启 Overlap 还不够;参与重叠的另一个 Primitive Component 也必须允许生成 Overlap 事件。对于标准 Character,通常由 Capsule Component 承担这项职责。

用一个Actor处理进入和离开

下面创建一个带 UBoxComponent 的区域 Actor。它只监听 Pawn 通道,在首次进入时记录一次状态;当 bTriggerOnce 为 true 时,之后的再次进入会被忽略,但离开事件仍然可以正常到达。

cpp
#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "ZoneTrigger.generated.h"

class UBoxComponent;
class UPrimitiveComponent;

UCLASS()
class AZoneTrigger : public AActor
{
    GENERATED_BODY()

public:
    AZoneTrigger();

protected:
    virtual void BeginPlay() override;

    UPROPERTY(VisibleAnywhere)
    TObjectPtr<UBoxComponent> Trigger;

    UPROPERTY(EditAnywhere, Category = "Trigger")
    bool bTriggerOnce = false;

    bool bConsumed = false;

    UFUNCTION()
    void OnTriggerBegin(
        UPrimitiveComponent* OverlappedComponent,
        AActor* OtherActor,
        UPrimitiveComponent* OtherComp,
        int32 OtherBodyIndex,
        bool bFromSweep,
        const FHitResult& SweepResult
    );

    UFUNCTION()
    void OnTriggerEnd(
        UPrimitiveComponent* OverlappedComponent,
        AActor* OtherActor,
        UPrimitiveComponent* OtherComp,
        int32 OtherBodyIndex
    );
};
cpp
#include "ZoneTrigger.h"

#include "Components/BoxComponent.h"
#include "GameFramework/Pawn.h"

AZoneTrigger::AZoneTrigger()
{
    Trigger = CreateDefaultSubobject<UBoxComponent>(TEXT("Trigger"));
    RootComponent = Trigger;

    Trigger->SetBoxExtent(FVector(150.0f, 150.0f, 100.0f));
    Trigger->SetCollisionEnabled(ECollisionEnabled::QueryOnly);
    Trigger->SetCollisionResponseToAllChannels(ECR_Ignore);
    Trigger->SetCollisionResponseToChannel(ECC_Pawn, ECR_Overlap);
    Trigger->SetGenerateOverlapEvents(true);
}

void AZoneTrigger::BeginPlay()
{
    Super::BeginPlay();

    Trigger->OnComponentBeginOverlap.AddDynamic(
        this,
        &AZoneTrigger::OnTriggerBegin
    );
    Trigger->OnComponentEndOverlap.AddDynamic(
        this,
        &AZoneTrigger::OnTriggerEnd
    );
}

void AZoneTrigger::OnTriggerBegin(
    UPrimitiveComponent* OverlappedComponent,
    AActor* OtherActor,
    UPrimitiveComponent* OtherComp,
    int32 OtherBodyIndex,
    bool bFromSweep,
    const FHitResult& SweepResult
)
{
    if (!OtherActor || !OtherActor->IsA<APawn>())
    {
        return;
    }

    if (bTriggerOnce && bConsumed)
    {
        return;
    }

    bConsumed = true;
    UE_LOG(LogTemp, Display, TEXT("Zone entered by Pawn"));
}

void AZoneTrigger::OnTriggerEnd(
    UPrimitiveComponent* OverlappedComponent,
    AActor* OtherActor,
    UPrimitiveComponent* OtherComp,
    int32 OtherBodyIndex
)
{
    if (!OtherActor || !OtherActor->IsA<APawn>())
    {
        return;
    }

    UE_LOG(LogTemp, Display, TEXT("Zone exited by Pawn"));
}

预期输出:把 AZoneTrigger 放进关卡,让玩家完整穿过盒体一次,Output Log 应依次出现:

text
LogTemp: Display: Zone entered by Pawn
LogTemp: Display: Zone exited by Pawn

如果 bTriggerOnce 为 true,玩家第二次进入时不会再出现 Zone entered by Pawn。如果希望区域每次都执行进入逻辑,把它保持为 false。

把机关动作和传感器分开

示例中的 UE_LOG 是最小验证点。实际项目里,Trigger 更适合发出“区域被进入”这一事实,再由门、灯、任务系统或关卡脚本决定怎么响应。这样同一个 Trigger 可以复用于开门、播放音效、切换战斗区域等不同场景。

需要“进入时开启、离开时关闭”的机关时,把开启逻辑放在 Begin Overlap,把关闭逻辑放在 End Overlap。需要一次性机关时,只在 Begin Overlap 使用 bConsumed 做门闩,不要立刻关闭 Generate Overlap Events,否则当前角色可能收不到对应的 End Overlap。

排查不触发和重复触发

完全不触发时,先检查 Trigger 与角色碰撞组件是否都开启 Generate Overlap Events,再确认双方的碰撞响应组合最终是 Overlap,而不是 Ignore 或 Block。如果角色一开始就出生在 Trigger 内,Begin Overlap 在关卡启动阶段出现属于有效情况,不应当按“玩家刚跨过边界”理解。

重复触发通常来自两个来源:角色上不止一个 Primitive Component 能与 Trigger 重叠,或者机关逻辑本身没有幂等保护。单玩家、单 Capsule 的简单关卡可以直接使用上面的实现;多人或多个对象同时进入同一区域时,应把“谁正在区域内”记录成 Actor 集合,而不是用单个布尔值代表整个区域。

当区域事件同时具备明确的碰撞过滤、进入与离开成对处理,以及一次性逻辑的门闩状态后,机关行为会比“所有逻辑都塞进 BeginOverlap”更容易扩展和排错。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理触发器与区域事件

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

登录哪都通