游戏引擎 / 系统课时

用事件驱动减少硬编码

用事件驱动减少硬编码

角色交互常从“拿到目标后直接调用具体类”开始,功能一多就会出现大量 Cast、对象引用和反向依赖。本课用 Unreal Engine 5 的接口、事件扩展点与 Delegate 拆开“发起动作”和“广播结果”,让门、UI、音效或任务系统可以独立变化。

学习目标

  • 区分接口调用、可覆写事件和多播 Delegate 的职责
  • 用能力接口替代对具体交互对象类型的硬编码
  • 让多个监听者订阅通知,而不是由角色逐个持有并调用

先区分命令与通知

“让这个目标执行交互”属于命令:发起者知道目标是谁,但不应该知道它是门、宝箱还是 NPC,适合用 Interface。“角色已经触发了一次交互”属于通知:发布者不需要知道谁关心它,适合用 Multicast Delegate 或 Blueprint Event Dispatcher。

可覆写 Event 更适合留扩展点。例如 C++ 定义稳定流程,在关键节点用 BlueprintNativeEvent 或 BlueprintImplementableEvent 交给蓝图补充表现。它解决的是“同一个对象怎样被子类扩展”,而不是“一条消息怎样广播给许多无关系统”。

机制 发布者是否知道接收者 适合场景
Interface 知道目标对象,不知道具体类型 对门、拾取物、NPC 统一调用 Interact
Delegate / Event Dispatcher 不知道具体监听者 UI、音效、任务系统监听同一结果
可覆写 Event 知道自己,允许子类补充实现 C++ 固定规则,蓝图补表现或资源差异

交互接口与事件通知的解耦关系

用接口封住具体对象类型

下面是片段示例,依赖项目中一个 UInteractionComponent 以及实现 IInteractable 的 Actor;代码展示接口与广播边界,不是独立可执行程序。BlueprintAssignable 让动态多播 Delegate 可以在蓝图中绑定监听者。

cpp
#pragma once

#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "UObject/Interface.h"
#include "InteractionComponent.generated.h"

UINTERFACE(MinimalAPI, Blueprintable)
class UInteractable : public UInterface
{
    GENERATED_BODY()
};

class IInteractable
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "Interaction")
    void Interact(AActor* InstigatorActor);
};

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(
    FOnInteractionTriggered, AActor*, Target);

UCLASS(ClassGroup = (Gameplay), meta = (BlueprintSpawnableComponent))
class UInteractionComponent : public UActorComponent
{
    GENERATED_BODY()

public:
    UPROPERTY(BlueprintAssignable, Category = "Interaction")
    FOnInteractionTriggered OnInteractionTriggered;

    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void TryInteract(AActor* Target);
};

片段示例的实现文件只负责检查能力、发送命令并发布通知,不需要判断 ADoor、APickup 等具体类型。

cpp
#include "InteractionComponent.h"

void UInteractionComponent::TryInteract(AActor* Target)
{
    if (!IsValid(Target) ||
        !Target->GetClass()->ImplementsInterface(UInteractable::StaticClass()))
    {
        return;
    }

    IInteractable::Execute_Interact(Target, GetOwner());
    OnInteractionTriggered.Broadcast(Target);
}

预期结果:当射线命中的 Actor 实现 IInteractable 时,它收到一次 Interact 调用;随后所有已绑定到 OnInteractionTriggered 的 UI、音效或任务监听者各收到一次通知。目标未实现接口时,函数直接返回,不需要 Cast 到任何具体交互类。

让订阅者自己管理生命周期

Delegate 的价值在于“发布者不维护监听者名单的业务含义”。UI 可以订阅交互事件显示提示,音效组件可以播放反馈,任务系统可以累计进度;删掉其中任意一个监听者,不应迫使 UInteractionComponent 修改逻辑。

如果在 C++ 中用 AddDynamic 手动绑定,建议在对应生命周期结束时用 RemoveDynamic 解除绑定,让绑定关系更容易审查。蓝图中使用 Event Dispatcher 时也遵守同一原则:由真正关心事件的对象负责绑定,而不是让角色去寻找 HUD、任务系统和音频对象再逐个调用。

判断什么时候不必事件化

并非所有直接调用都需要改成事件。角色拥有自己的 CharacterMovementComponent,这种稳定的父子关系直接调用最清楚;只有当调用方开始知道大量具体类型、为了通知多个系统保存许多可选引用,或新增一个接收者就必须修改发布者时,才值得引入接口或 Delegate。

验收时可以创建一个门和一个拾取物,让它们分别实现 Interact;再给 UI 与音效各绑定一个监听者。触发门后,应同时看到门自己的交互效果与两个独立监听者的反馈;移除 UI 绑定后,门和音效仍应正常工作。这说明交互能力、事件发布和事件消费已经真正分离。

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

目录与阅读设置

阅读设置

17

记录一个想法

用事件驱动减少硬编码

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

登录哪都通