UE5 C++中的委托详细说明

已于 2024-09-20 10:22:15 修改
阅读量1.9k 收藏 45
点赞数 11
分类专栏： UE4 文章标签： ue5 c++
于 2024-08-04 23:31:27 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/Motarookie/article/details/140872887
版权

文章目录

1、四种委托的基本概念

1.1 单播委托（Single-cast Delegate）

  • 不带参数

    • 声明方式: DECLARE_DELEGATE(FMyDelegate);
    • 广播方式: MyDelegate.Execute();
    • 回调签名: void SomeFunction();

  • 带参数

    • 声明方式: DECLARE_DELEGATE_OneParam(FMyDelegate, int32)
    • 广播方式: MyDelegate.Execute(42);
    • 回调签名: void SomeFunction(int32 Value);

说明: 单播委托适合用于一个事件只需要调用一个函数的情况，参数个数可以多个（所有委托的参数都可以0~9个），参数类型必须给，参数名随意，但回调函数中必须给参数名。

1.2 多播委托（Multi-cast Delegate）

  • 不带参数

    • 声明方式: DECLARE_MULTICAST_DELEGATE(FMyMulticastDelegate);
    • 广播方式: MyMulticastDelegate.Broadcast();
    • 回调签名: void SomeFunction();

  • 带参数

    • 声明方式: DECLARE_MULTICAST_DELEGATE_OneParam(FMyMulticastDelegate, int32);
    • 广播方式: MyMulticastDelegate.Broadcast(42);
    • 回调签名: void SomeFunction(int32 Value);

说明: 多播委托适合用于一个事件需要调用多个函数的情况。同样，参数名在声明时可选，但在回调函数签名中必须包含。

1.3 动态单播委托（Dynamic Delegate）

  • 不带参数

    • 声明方式: DECLARE_DYNAMIC_DELEGATE(FMyDynamicDelegate);
    • 广播方式: MyDynamicDelegate.Execute();
    • 回调签名: UFUNCTION() void SomeFunction();

  • 带参数

    • 声明方式: DECLARE_DYNAMIC_DELEGATE_OneParam(FMyDynamicDelegate, int32, Value);
    • 广播方式: MyDynamicDelegate.Execute(42);
    • 回调签名: UFUNCTION() void SomeFunction(int32 Value);

说明: 动态单播委托用于需要与蓝图交互的场景，它们可以在蓝图中绑定和解绑，回调函数必须使用 UFUNCTION() 修饰，以便在蓝图中进行绑定（C++中当然也可以）。带参数的动态委托在声明时必须指定参数名称，因为动态委托需要支持反射和序列化，参数名称需要反射到蓝图里面用。

1.4 动态多播委托（Dynamic Multicast Delegate）

  • 不带参数

    • 声明方式: DECLARE_DYNAMIC_MULTICAST_DELEGATE(FMyDynamicMulticastDelegate);
    • 广播方式: MyDynamicMulticastDelegate.Broadcast();
    • 回调签名: UFUNCTION() void SomeFunction();

  • 带参数

    • 声明方式: DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FMyDynamicMulticastDelegate, int32, Value);
    • 广播方式: MyDynamicMulticastDelegate.Broadcast(42);
    • 回调签名: UFUNCTION() void SomeFunction(int32 Value);

说明: 动态多播委托类似于动态单播委托，但可以绑定多个回调函数，同样需要 UFUNCTION() 修饰回调函数，并且在声明时必须包含参数名称。由于蓝图需要通过反射机制识别参数名称，因此在声明动态多播委托时，参数名称是必须的。

2. 委托的绑定方式

单播绑定回调的接口前缀都是：Bind

多播添加回调的接口前缀都是：Add

动态必须用后缀：Dynamic，且回调函数必须带UFUNCTION()标记

接口的后缀表示函数的类型：

  • UObject子类的成员函数：UObject
  • 普通类的成员函数：Raw
  • 静态/全局函数：Static
  • Lambda表达式：Lambda

2.1 单播委托

  • 绑定普通成员函数

    • 使用 BindUObject 绑定成员函数：
      MyDelegate.BindUObject(this, &MyClass::MyFunction);
    • 使用 BindStatic 绑定静态函数或全局函数：
      MyDelegate.BindStatic(&MyStaticFunction);

  • 绑定Lambda表达式

    • 使用 BindLambda 绑定Lambda：
      MyDelegate.BindLambda([]() { 。。。。 });

说明: BindUObject 适用于绑定类的成员函数，this 指针需要指向类的实例。如果绑定静态函数或全局函数，则使用 BindStatic。

2.2 多播委托

  • 添加普通成员函数

    • 使用 AddUObject 添加成员函数：
      MyMulticastDelegate.AddUObject(this, &MyClass::MyFunction);

  • 添加Lambda表达式

    • 使用 AddLambda 添加Lambda：
      MyMulticastDelegate.AddLambda([]() { /* Your code here */ });

  • 添加静态函数或全局函数

    • 使用 AddStatic 添加静态函数：
      MyMulticastDelegate.AddStatic(&MyStaticFunction);

说明: 多播委托允许添加多个回调函数，每个回调函数都会在广播时依次被调用。AddUObject 用于绑定类的成员函数，AddStatic 用于绑定静态或全局函数。

2.3 动态单播委托

  • 绑定到成员函数
    • 使用 BindDynamic 绑定到成员函数：
      MyDynamicDelegate.BindDynamic(this, &MyClass::MyFunction);

说明: 动态单播委托只能通过 BindDynamic 绑定到使用 UFUNCTION() 修饰的成员函数。这是因为动态委托需要支持反射，才能在蓝图中进行绑定和解绑。

2.4 动态多播委托

  • 添加成员函数

    • 使用 AddDynamic 添加成员函数：
      MyDynamicMulticastDelegate.AddDynamic(this, &MyClass::MyFunction);

  • 移除成员函数

    • 使用 RemoveDynamic 移除绑定的成员函数：
      MyDynamicMulticastDelegate.RemoveDynamic(this, &MyClass::MyFunction);

说明: 动态多播委托允许在运行时动态地添加和移除回调函数。同样，AddDynamic 绑定的函数必须是使用 UFUNCTION() 修饰的成员函数。

绑定方法说明

  • AddUObject() 与 AddDynamic() 的区别

    • AddUObject() 用于多播委托的非动态绑定，适合绑定成员函数，不需要 UFUNCTION() 修饰。
    • AddDynamic() 则用于动态多播委托的绑定，回调函数必须使用 UFUNCTION() 修饰，以支持反射机制。

  • BindLambda() 与 AddLambda() 的区别

    • BindLambda() 用于单播委托绑定 Lambda 表达式，适合在需要灵活性且只需要一个回调的场景。
    • AddLambda() 则用于多播委托，允许绑定多个 Lambda 表达式。

3、绑定回调的方式总结

绑定回调函数给委托的方法有很多，下面总结一下。

这只是其中一部分，举一反三，其他的方法看其注释即可了解如何使用以及使用场景

3.1 AddDynamic()

适用于
绑定到动态委托（DECLARE_DYNAMIC_MULTICAST_DELEGATE 或 DECLARE_DYNAMIC_DELEGATE）的回调函数，回调函数必须是 UFUNCTION。

签名

void AddDynamic(UserClass* InUserObject, UserClass::FuncType InFunc);

使用

Button->OnClicked.AddDynamic(this, &AMyActor::OnButtonClicked);

3.2 AddUObject()

适用于
将普通的 UObject 类成员函数绑定到委托，适用于非动态委托。回调函数不需要是 UFUNCTION，可以是任何成员函数。

签名

void AddUObject(UserClass* InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.AddUObject(this, &AMyActor::MyFunction);

3.3 AddLambda()

适用于
将一个匿名函数绑定到委托，适用于任何类型的委托。

签名

void AddLambda(TFunction<ReturnType(ParamTypes...)> Lambda);

使用

SomeDelegate.AddLambda([]() { });

3.4 AddRaw()

适用于
将普通的 C++ 类的成员函数绑定到委托。这种方法通常用于非 UObject 的普通 C++ 类，回调函数不需要是 UFUNCTION，可以是任何成员函数。

签名

void AddRaw(UserClass* InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.AddRaw(this, &AMyActor::MyFunction);

3.5 AddSP()

适用于
绑定智能指针类型的类成员函数，特别是 TSharedPtr 或 TWeakPtr 类型的对象。

签名

void AddSP(TSharedPtr<UserClass> InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.AddSP(MySharedPtr, &MyClass::MyFunction);

3.6 AddUFunction()

适用于
动态地将一个 UFunction 绑定到委托。通常用于需要在运行时绑定某个 UFUNCTION 的情况，函数名以字符串形式提供。

签名

void AddUFunction(UObject* InUserObject, FName InFunctionName);

使用

TransformProxy->OnEndTransformEdit.AddUFunction(this, FName("OnEndWidgetCompTransformEdit"));

3.7 AddStatic()

适用于
将静态函数绑定到委托。静态函数不依赖于任何对象实例，因此它们不能访问类的成员变量或成员函数。

签名

void AddStatic(FuncType InStaticFunc);

使用

SomeDelegate.AddStatic(&MyStaticFunction);

3.8 BindLambda()

适用于
将一个 Lambda 表达式绑定到委托，与 AddLambda() 类似，但它是通过直接绑定的方式，而不是添加到已有的绑定列表中，如果之前有绑定的回调，这个操作会替换掉之前的回调函数。

签名

void BindLambda(TFunction<ReturnType(ParamTypes...)> Lambda);

使用

SomeDelegate.BindLambda([](int32 Param) { /* Your code here */ });

3.9 BindRaw()

适用于
与 AddRaw() 类似，但它是直接绑定到委托，而不是添加到绑定列表中。通常用于非 UObject 类的成员函数绑定，回调函数不需要是UFUNCTION。

签名

void BindRaw(UserClass* InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.BindRaw(this, &AMyActor::MyFunction);

3.10 BindUObject()

适用于
将 UObject 成员函数直接绑定到委托。

签名

void BindUObject(UserClass* InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.BindUObject(this, &AMyActor::MyFunction);

3.11 BindSP()

适用于
将智能指针类型的类成员函数绑定到委托，特别是 TSharedPtr 或 TWeakPtr 类型的对象。

签名

void BindSP(TSharedPtr<UserClass> InUserObject, UserClass::FuncType InFunc);

使用

SomeDelegate.BindSP(MySharedPtr, &MyClass::MyFunction);

3.12 BindUFunction()

适用于
将一个 UFunction 绑定到动态委托。通常用于需要在运行时绑定某个 UFUNCTION 的情况，函数名以字符串形式提供。

签名

void BindUFunction(UObject* InUserObject, FName InFunctionName);

使用

SomeDelegate.BindUFunction(this, FName("MyUFunctionName"));

3.13 AddWeakLambda()

适用于
专门为弱引用对象（如 TWeakObjectPtr）设计的，防止由于绑定的对象已经销毁而导致的崩溃，当绑定的对象被销毁时，不会执行 Lambda 表达式。。

签名

void AddWeakLambda(TWeakObjectPtr<UserClass> InWeakObjectPtr, TFunction<ReturnType(ParamTypes...)> InLambda);

使用

SomeDelegate.AddWeakLambda(WeakObjectPtr, [](int32 Param) { });
UE5--浅析委托原理（Delegate）
qq_52269550的博客
02-10 1747
委托是一种用于事件处理的机制。通过使用委托，可以将一个或多个函数绑定到一个事件上，在事件触发时自动调用这些函数。代理也叫做委托，比如：跳，跑，开枪，伤害等响应，就是注册一个委托回调，其作用就是提供一种消息机制，都知道消息的传递需要发送方和接收方，而代理的过程也可分为这两大部分，我们可以换个名字分别叫做：触发点和执行点，这就是代理的主要部分，记住这个两个点就能记住代理原理。这里面也有很多的类型擦除，类型还原，还有函数签名转换。
【虚幻UE5-C++】--- Unreal Engine 中的委托：广播、绑定和回调
m0_59649626的博客
02-07 3295
在虚幻引擎中，委托（Delegate）是一种用于事件通知和回调的机制。委托允许将一个或多个函数绑定到特定的事件，并在事件发生时通知这些函数执行相应的操作。在头文件中定义委托类型，通常使用或宏。通过委托，Unreal Engine 提供了一种灵活且强大的方式来实现事件驱动编程。广播、绑定和回调构成了委托模式的核心，为游戏开发者提供了一种优雅而高效的代码结构。希望本文能够帮助开发者更好地理解 Unreal Engine 中委托的概念，并在实际项目中充分发挥其威力。
UE_C++ —— Delegates
NapoleonCoder的博客
02-23 980
委托；
UE5 C++（十二）— 委托（代理）、多播委托
qq_40120946的博客
01-05 2750
这个官网上有很详细介绍，这里介绍几个点委托 是一种泛型但类型安全的方式，可在C++对象上调用成员函数。可使用委托动态绑定到任意对象的成员函数，之后在该对象上调用函数，即使调用程序不知对象类型也可进行操作。复制委托对象很安全。你也可以利用值传递委托，但这样操作需要在堆上分配内存，因此通常并不推荐。请尽量通过引用传递委托。
UE5 C++基础：委托（Delegate）
夕木牛牛的博客
11-04 766
在编程中，委托是一种可以指向函数的对象。简单地说，委托就像是一个“函数指针”，但它更加安全和灵活。它允许程序在运行时动态地调用不同的函数。
【UE·C++】虚幻引擎中的委托（代理) Delegate
记录日常开发的小问题备忘
10-17 3629
自从看了虚幻引擎的C++源代码，并使用虚幻C++开发了3个多月以来，心中对虚幻的技术团队有一种莫名的崇拜，没想到他们能将C++用的如此出神入化，希望可以站在巨人的肩膀上，继续砥砺前行。今天来总结一下虚幻中的委托。委托模式，在面向对象设计模式也是一种很常见的模式：它可以看做是函数的抽象，是函数的“类”。委托的实例将代表一个具体的函数，一个委托可以搭载多个方法，所有的方法被依次唤起，可以使委托对象所搭载的方法并不需要属于同一类。（网上找的简单的定义），它。
【UE5 C++基础 14】委托
关宅
07-13 1180
先把函数交给一个委托类， 把另一个函数交给另一个委托类， 把两个委托类组合起来，成为一个组合委托组合委托被调用，会依次执行多个委托里的函数
UE5蓝图与C++通信方式大全
hege1998的博客
10-18 1193
在NPCCharacter蓝图中，创建一个名为ShowDialog的自定义事件。在PlayerCharacter中，通过直接引用或者接口获取NPCCharacter实例，然后调用ShowDialog事件。
UE5 C++ 斯坦福 Note1
关宅
08-10 1824
Class Hierarchy （类的层次结构） Object 所有虚幻实例的基类 √ Actor 可以被放置或生成在世界中的Object √ √ Pawn 可以被玩家或AI控制的Actor √ √ √ Character 包含移动组件的Pawn √ √ √ √ *Character 我们继承重写的C++类 .....................
UE5 C++ 委托
最新发布
03-31
### UE5 C++ 委托的用法与实例 在 Unreal Engine 5 (UE5) 的开发过程中，委托（Delegate）是一种强大的工具，用于实现对象之间的通信和事件处理机制...以上便是有关 UE5 中 C++ 委托的一些基本概念及其应用案例介绍。
C++实现UE委托
游戏弱鸡
04-05 1383
#include<iostream> #include<vector> #include "Functional" /** * 所涉及的知识点： * （1）typedef的函数指针定义方式 * （2）Using的函数指针定义方式 * （3）单播绑定和执行的过程（C++仿照UE） * （4）Function的使用——bind以及对这种包装器（std::function<void(int, int)> ）的使用 * （5）多播的实现（Fdelegate的类中的p
【UE5 C++课程系列笔记】08——单播委托的基本使用
ChaoChao66666的博客
12-12 1653
目录 概念 一. 单播委托 二. 多播委托 三. 动态单播/多播 单播委托——申明委托 一、DECLARE_DELEGATE 二、DECLARE_DELEGATE_OneParam 三、DECLARE_DELEGATE_TwoParams 四、DECLARE_DELEGATE_Params（通用多参数形式） 五、DECLARE_DELEGATE_RetVal 六、DECLARE_DELEGATE_RetVal_OneParam 七、DECLARE_DELEGATE_RetV
UE5源码小记— Delegate（委托）
ninesnow_c的博客
06-29 1331
花了三天时间简单看了看ue5种委托功能的源码，很有收获,很多地方写的很巧妙。在看源码之前有几个点需要重点关注，比如内存布局，类型擦除，函数签名转换。
UEC++ 代理/委托
dageliuqing的博客
09-22 1392
原始指针不使用任何类型的引用，因此如果从委托下面删除了对象，则调用此函数可能不安全。UKismetSystemLibrary::PrintString(this, TEXT("无返回值无参数函数调用！UKismetSystemLibrary::PrintString(this, TEXT("无返回值无参数函数调用！从该多播委托的调用列表中删除绑定到指定UserObject的所有函数。从该多播委托的调用列表中删除函数（性能为O(N)）。共享指针委托保留对对象的弱引用。将函数委托添加到该多播委托的调用列表中。
【UE】UEC++委托代理
Hank_W
11-30 978
UEC++委托代理
事件分发器/委托快速入门 ue5
sher_chang的博客
08-14 1703
我们的代理有几个步骤，一个是定义这个代理，然后在类中要实例化一个delegate，然后bind，然后execute这个代理中的方法。回到我们的正常的实现在声明之后，在类中实例化他。下面的代码中，hadle是函数，虚函数是继承的需要实现的一个函数，还有就是我们实例化的一个delegate，OnBossDiedprotected:public:然后在cpp中我们绑定一个简单的box组件设置基础的星系。然后在handle函数中执行这个delegate。
UE C++学习（二）之 委托，Gamemode基础类，不同Pawn切换，映射，伤害TakeDamage等
qq_58814201的博客
09-01 562
（3）DECLARE_DYNAMIC_MULTICAST_DELEGATE：多播，分别用蓝图的形式编写，可以编写多个客户端，也可以使用C++（1）DELARE_DELEGATE:是最简单的版本，带有一个参数DelegateName 是我们可以分配给委托的名称，只能在C++中使用。（2）DECLARE_DYNAMIC_DELEGATE：这个委托的不同之处在于，可以做蓝图中使用。委托可以存储对 具有任意类的特定签名的方法 的引用，并在必要时调用此方法。
UE（委托，接口）
sengyongan的博客
09-27 1061
在其他类包含接口头文件，多重继承public I接口类名（一定注意I），重写声明：Virtual 函数 _Implementation(一定要加，因为声明） ovrried。
【UE5】蓝图
weixin_64072619的博客
11-22 1606
在开发过程中，不可避免地会有一些蓝图的操作。同时，蓝图也是UE很有特色的一个内容。
UE5中的C++动态多播委托如何和蓝图中的事件绑定
06-07
UE5中的C++动态多播委托可以在蓝图中使用事件绑定来连接。以下是具体步骤： 1. 在C++中声明动态多播委托 例如，您可以在一个Actor类中声明一个动态多播委托： ```cpp DECLARE_DYNAMIC_MULTICAST_DELEGATE(FMyDelegate); ``` 2. 在C++中声明和定义触发委托的函数 例如，您可以在同一个Actor类中声明和定义一个触发委托的函数： ```cpp UFUNCTION(BlueprintCallable) void TriggerMyDelegate(); ``` 3. 在蓝图中创建事件 打开蓝图编辑器，选择您想要绑定事件的Actor，然后在右侧的“事件图”面板中创建一个事件节点。 4. 将事件节点绑定到委托 将事件节点拖动到C++中声明的委托变量上，然后选择“Bind to Delegate”选项。 5. 连接事件节点 将事件节点连接到您在C++中声明的触发委托的函数节点上。 现在，当您在C++中触发委托时，蓝图中的事件将被触发并执行相应的操作。请注意，在蓝图中绑定委托时，需要确保委托的签名与事件节点的签名相匹配。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

宗浩多捞

您的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值