UnrealC++のデリゲート、イベントについて

UE4のデリゲート関連、なんかいろいろあって混乱しているのでまとめる
元ネタのC#、UEC++、BPエディタでの使用について確認していく

UE4のデリゲートはC#の物を元にしているっぽいのでそちらを軽く確認しておく

シングルキャストデリゲート

delegate void DelegateA();
DelegateA a = hogeA.A;
a();

a += hogeB;

イベント

Unreal Engine | デリゲート

UnrealC++ではデリゲートが用意されていて、用途によって数種類のマクロが用意されている

	通常(C++内のみ)	動的(エディタに公開)
シングルキャスト	DECLARE_DELEGATE	DECLARE_DYNAMIC_DELEGATE
マルチキャスト	DECLARE_MULTICAST_DELEGATE	DECLARE_DYNAMIC_MULTICAST_DELEGATE
イベント	DECLARE_EVENT	-

通常・動的の違い

通常シングルキャストデリゲート

動的シングルキャストデリゲート

通常マルチキャストデリゲート

動的マルチキャストデリゲート

通常イベント

代入できる数	複数
戻り値	不可
ペイロード	可
BPでの見え方	アクセス不可
代入	Add(), AddUObject()...
実行	Broadcast()
備考	Broadcast()等一部メソッドは宣言クラス内からのみアクセス可

外部クラスからBroadcast()出来ないのがEventってドキュメントに書いてるけど(C#のEventにちかい)、実装クラスでイベントがpublic指定子だったり参照返してもらったりで普通に外部クラスからも呼べちゃえるきがする

Unreal Engine | 動的デリゲート
 Unreal Engine | イベント

イベントノード

戻り値がvoidの関数のエントリーノード
C#, UE4C++のイベントとは全く関係がない
ノードの右上の赤い■からDelegate型のピンが伸びる、これをシグネチャが一致しているDelegate型変数やイベントディスパッチャーのbindノードにつなぐことが出来る

Unreal Engine | イベント

UnrealC++でいうところの動的シングルキャストデリゲート
C++で動的シングルキャストデリゲートとして実装されているメンバに対して、UPROPERTY(BlueprintReadWrite)が設定されている時にGet、Setノードよりアクセスが出来る
エディタ内からはこのようなDelegate型の変数を作成することはできない
エディタからこのデリゲートを実行したいなら専用の関数を実装する必要がある(あるいは適当なイベントディスパッチャーにbindする)

	C++	BP
関数(イベント)の追加	Bind()	Set()
デリゲートの実行	Excute()	-

イベントディスパッチャー

UnrealC++でいうところの動的マルチキャストデリゲート
C++で動的マルチキャストデリゲートとして宣言した変数にUPROPERTY(BlueprintAssignable)が指定されてるさい、その変数名がイベントディスパッチャー欄に表示される
UPROPERTYにBlueprintCallableを指定すると、エディタ内でCallイベントノードを使用できるようになる

	C++	BP
関数(イベント)の追加	Add()	Bind()
デリゲートの実行	Broadcast()	Call()

Unreal Engine | BlueprintAssignable
Unreal Engine | BlueprintCallable
UE4 C++でイベント/イベントディスパッチャーを作る - GameProgrammar's Night

#memo