风蚀之月

事件调度器及C++中的使用

16 Aug 2015 UE4 事件调度器 Delegate

事件调度器非常的适合在各个蓝图之间实现通信功能。

当前UE4版本4.8.3。

在蓝图中,事件调度器的作用就像是事件的派发器。通过将事件预先的绑定在事件调度器上,可以让系统可以在需要时将事件派发给所有已经绑定的事件。

事件调度器的使用

一个比较常见的使用事件调度器的地方,就是关卡蓝图。

关卡蓝图中的很多物体的Actor及其逻辑,如果要脱离关卡蓝图的话会比较难于使用。因此,可以通过将关卡蓝图中实现好的功能绑定到某个类,例如GameMode的事件调度器上来方便调度。

如下图,在关卡蓝图的BeginPlay中将功能绑定到GameMode上:

image

然后可以在GameMode的蓝图中,设定定时的调度关卡蓝图上的功能

image

事件调度器同时支持解绑和解绑全部,以方便对事件调度的逻辑进行进一步的控制。

Delegate

在C++和蓝图混合使用时,使用Blueprint Function Library可以方便的实现蓝图到C++的调用。如果要实现C++对蓝图的逻辑的话,事件调度机制就非常的方便。

在C++中,与事件调度器对应的是Delegate机制。事实上,Delegate机制的涵盖范围比事件调度器要大一些。

Delegate机制是一种常见的设计模式,相信做程序的童鞋都比较熟悉。这里不做多余的说明了。

UE4官方对Delegate的翻译名称唯代理。按照类型,分为单播代理和多播代理。其中,多播代理与事件调度器的功能类似,而单播代理更接近单纯的代理,也就是只能绑定一个执行函数。

要让多播代理像是事件调度器一样使用的话,需要将其定义为Dynamic。对于单播代理也是一样的。

在C++中使用UE4的代理功能,需要使用官方提供的宏进行定义。

函数签名 声明宏
void Function() DECLARE_DELEGATE( DelegateName )
void Function( ) DECLARE_DELEGATE_OneParam( DelegateName, Param1Type )
void Function( , ) DECLARE_DELEGATE_TwoParams( DelegateName, Param1Type, Param2Type )
void Function( , , ... ) DECLARE_DELEGATE_Params( DelegateName, Param1Type, Param2Type, ... )
Function() DECLARE_DELEGATE_RetVal( RetValType, DelegateName )
Function( ) DECLARE_DELEGATE_RetVal_OneParam( RetValType, DelegateName, Param1Type )
Function( , ) DECLARE_DELEGATE_RetVal_TwoParams( RetValType, DelegateName, Param1Type, Param2Type )
Function( , , ... ) DECLARE_DELEGATE_RetVal_Params( RetValType, DelegateName, Param1Type, Param2Type, ... )

针对不同的代理类型,使用不同的宏前缀即可:

   
多播代理 DECLARE_MULTICAST_DELEGATE…
动态单播代理 DECLARE_DYNAMIC_DELEGATE…
动态多播代理 DECLARE_DYNAMIC_MULTICAST_DELEGATE…

实际使用时,首先要对代理类型进行定义

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FDspLRValDelegate, float, LVals, float, RVals);

然后在具体的类,例如GameState中进行具体的声明

UPROPERTY(BlueprintAssignable, Category = "SoundFuncs")
    FDspLRValDelegate  DspLRVals;

这样一来,就可以在需要调用这个代理的地方进行调用了,例如在某个数据生成的地方。

AMyGameState* tags = Cast<AMyGameState>(SL_Contex.LC_cGameState);
if (tags)
    tags->DspLRVals.Broadcast(tfLval, tfRval);

之后,就可以在蓝图中向这个多播代理绑定事件来获得生成的数据了

image

总结

事件调度器的机制在逻辑实现中非常的方便,尤其是在关卡设计中,可能会比较经常用到。使用中也没有遇到什么特别需要注意的地方,逻辑很单纯。