こちらは UE4 Advent Calendar 2015 4日目の記事です。
プログラマ向けの内容となります。
実装例編はコチラ。

ゲーム等のインタラクティブなコンテンツを作っている時によく使うノードに「SpawnActorFromClass」や「ConstructObjectFromClass」があります。
これらのノードは他と少し違う機能を備えているのですが、お気付きでしょうか？
その機能とは、「入力ピンで指定したクラスによって、他の入力ピンや出力ピン内容が動的に変更される」というものです。

例えば SpawnActorFromClass を配置して、入力ピンに Character クラスを指定するとします。
SpawnActorFromClass で入力ピンのクラスを指定する前は以下の様な状態ですが、

Character クラスを指定すると、出力ピンの型が「Actor Reference」から「Character Reference」に変わります。
また、新たな入力ピンとして「Instigator」が出現していたり、地味にノードタイトルが変わっていたりします。

今回はこれをプロジェクト用に拡張してみます。

SpawnActorFromClass を例に取った構成の解説

BlueprintFunctionLibrary のような一般的なノードを作成するのであれば、クラスに static 関数として定義して UFUNCTION マクロを用いて関数指定子を適切に設定することで作成できます。
しかし今回のような特殊なノードを作成したい場合は、UK2Node クラスを継承して実装してあげる必要があります。

SpawnActorFromClass ノードを例に取ります。
このノードは UK2Node クラスを継承した UK2Node_SpawnActor クラスで実装されています。
カスタムノードを作成するために override できる関数をいくつか紹介します。
※ SpawnActorFromClass 内のコードは載せませんが、後で具体的な拡張事例を載せてますのでそちらをご覧下さい。

兎にも角にも一番のキモは ExpandNode です。
ここで何をやっているのかが理解できれば、大抵のカスタムノードの挙動は理解できると思います。

これら以外にも拡張のための関数がいくつか定義されていますので、もっと深く知りたい方は K2Node_SpawnActor や K2Node_ConstructObjectFromClass、K2Node_CreateWidget あたりを読んでみると理解が進むかと思います。

ちなみに単純に SpawnActor や ConstructObjectFromClass の候補を絞りたいといった時は、継承して GetClassPinBaseClass をオーバーライドするだけでいいので簡単です。

実装例

上記の実装例に関しては別ページにまとめてありますので、コチラからどうぞ。

注意事項

今回紹介したノードの入力/出力ピンを動的に変更する仕組みは、あくまでエディタ上で編集する際に決定するものでしか内部で判断できません。

つまり入力ピンとして Enum を用意し、その値を元に出力ピンの型を変えたいといった場合は、Enum の値が実行時に変化するために出力の型を編集時に決定させることができません。

（ただ、UK2Node_Switch みたいに動的に出力実行ピンの実行先を変更することはできるので、通信内容をデシリアライズして内容に合わせて処理分岐、みたいなことは可能かと思います）

終わりに

C++を記述する必要はありますが、ノード拡張周りができるようになると、Blueprint からできることの幅が一気に広がります。

興味がある方は色々なノードの内部実装周りを見てみると良いかと思います。

明日は @kurosaurus さんの記事です。

SpriteStudio 周りを書いてもらえるとのことで、とても期待ですね。