‫お帰りなさい｡
‫さて､ 今回のビデオでは､ ヒットイベントについてお話します｡
‫弾が何かにぶつかったら､ それを検知して破壊するなどの対応ができればと思います｡
‫あと､ ダメージを与えたり､ 爆発効果を起こしたりするのも､ 後で処理します｡
‫では､ ここからはヒット商品について少しお話します｡
‫私たちの弾丸はメッシュ成分を含んでいます｡
‫タイプは静的メッシュコンポーネントで､ 静的メッシュコンポーネントは長い階層構造の中の1つのクラスであり､
‫アンリアルエンジンシステムではその親の1つがプリミティブコンポーネントです｡
‫以下は､ プリミティブコンポーネントのドキュメントページです｡
‫プリミティブコンポーネントとは､ 一般的にレンダリングやコリジョンデータとして使用される､ ある種のジオメトリを含む､
‫または生成するコンポーネントを指すと書いてありますね｡
‫つまり､ 基本的にはシーンコンポーネントで､ いくつかの機能を追加したものです｡
‫下にスクロールして階層を見ると､ you seen componentとそこから派生したyou primitive
‫componentがあり､ さらに下にスクロールしてyouから派生した他のクラスもすべて見ることができます｡
‫プリミティブコンポーネント｡
‫ここで､ なぜこのような指摘をするかというと､ 静的メッシュコンポーネントは､ これらの機能をプリミティブコンポーネントから継承し､
‫プリミティブコンポーネントにはヒットイベントを発生させる機能があるからです｡
‫さて､ ヒットイベントを発生させるとはどういうことでしょうか｡
‫さて､ 右の矩形で表されるジオメトリが世界にあり､ 左の円で表される静的メッシュコンポーネントを持つオブジェクトがあるとします｡
‫さて､ 静的メッシュコンポーネントを持つこのオブジェクトがブロックに向かって移動している場合､ このコンポーネントがヒットイベントを処理するように設定されていれば､
‫ブロックに衝突すると同時にヒットイベントが生成されます｡
‫衝突イベントが発生すると､ 衝突したコンポーネントなど､ 衝突に関連するデータが生成されます｡
‫つまり､ このブロックには静的なメッシュコンポーネントが含まれている可能性があります｡
‫衝突時にその部品にアクセスすることができる｡
‫また､ ヒットしたアクターにもアクセスでき､ ヘッドイベントではEFのヒット結果も生成されます｡
‫Fのヒット結果について少し学びましたが､ ヒットした場所（世界の中の場所を表すFベクトル）など､
‫ヒットしたイベントに関する多くの変数が含まれていることがわかりました｡
‫これで投射物のメッシュができました｡
‫静的メッシュコンポーネントポインタの型変数です｡
‫さて､ この静的メッシュコンポーネントが世界の何かにぶつかるたびに､ それに反応するコードを用意したいと思います｡
‫静的メッシュコンポーネントであるため､ プリミティブコンポーネントクラスを継承しています｡
‫継承するものの一つに､ on component hitという変数がある｡
‫さて､ ここでコンポーネントのヒットに関するドキュメントを紹介します｡
‫When a Component Hits or is hit by something solidというイベントとして記述されています｡
‫さて､ 下にスクロールしてみると､ コンポーネントのヒットにはタイプFのコンポーネントヒットのサインがあることがわかります｡
‫そして､ これをクリックすると､ Fコンポーネントのヒットシグネチャが構造体であることがわかります｡
‫さて､ 話を戻すと､ ドキュメントには､ コンポーネントが何か固いものに当たったり､ ぶつかったりしたときに呼び出されるイベントと書かれていることがわかります｡
‫この現象は､ スイープを有効にしてセットロケーションを使用したキャラクターの移動や､ トリガーに歩いてぶつかるなどオブジェクトが重なるイベントの物理シミュレーションなどが原因で発生する可能性があります（オーバーラップイベントを参照）｡
‫だから､ ヒットしたイベントもあれば､ 重なったイベントもある｡
‫ヒット商品に拘る｡
‫つまり､ on component hitはドキュメントではヒットイベントとして記述されており､ on component hitはF component
‫hit signatureという型の構造体であることが分かっています｡
‫今のところ順調です｡
‫さて､ このコンポーネントヒット時のイベントは､ マルチキャストデリゲートと呼ばれるものでもあります｡
‫マルチキャストデリゲートは､ 複数の機能をバインドすることができます｡
‫複数のクラス上に存在する関数もあり得る｡
‫そして､ これらの関数がこのマルチキャストデリゲートに束縛されると､ 呼び出しリストと呼ばれるものに追加される｡
‫このヒットイベントが指示したときに､ すべての関数を呼び出すためのリストである｡
‫このヒットイベントやマルチキャストデリゲートは､ 何かが起こったときにブロードキャストすると言います｡
‫つまり､ 投射メッシュが何かにぶつかると､ このデリゲートは､ このデリゲートにバインドされている関数を持つすべてのクラスにブロードキャストします｡
‫そのブロードキャストが送信されると同時に､ そのブロードキャストに応答して､ これらのバインドされた関数がすべて呼び出されるのです｡
‫これは､ Unreal Engine の非常に強力な機能です｡
‫衝突などのイベントを待つデリゲートと呼ばれるものを持つことができるのです｡
‫そして､ その後に｡
‫そして､ デリゲートはブロードキャストされ､ その結果､ ブロードキャストに応答してすべてのバインドされた関数が呼び出されることになります｡
‫この繊細さに複数の機能を束ねることができるため､ マルチキャストと呼んでいます｡
‫機能をバインドした複数のクラスにブロードキャストしている｡
‫さて､ このデリゲートに関数をバインドするにはどうしたらいいでしょうか｡
‫さて､ コンポーネントヒットには､ これを可能にするいくつかの機能があり､ その一つがadd dynamicと呼ばれるものです｡
‫つまり､ ADDダイナミック関数を呼び出すときに必要なのは､ 2つのパラメータ､ つまり､ これを使うことができるユーザーオブジェクトと､
‫コールバック関数､ つまり､ クラス上の何らかの関数のアドレスを渡すだけです｡
‫そこで､ このon component hit delegateにアクセスしてadd dynamic関数を呼び出すと､ ユーザーオブジェクトとコールバックを渡すことができるようになります｡
‫そして､ この結果､ そのコールバックがヒットイベントの呼び出しリストに追加されます｡
‫コンポーネントがヒットすると､ このデリゲートをブロードキャストし､ このデリゲートにバインドされている関数が呼び出されます｡
‫そこで､ このデリゲートにバインドするために､ コールバック関数を作成する必要があります｡
‫ここにprojectileがあり､ ヒットイベントのコールバック関数が必要です｡
‫では､ ここにプライベート関数を作って､ それをvoidにしましょう｡
‫そして､ 私はこれを単純にヒットと呼ぶことにする｡
‫これをどう呼んでもいいのですが､ onは十分に説明的だと思います｡
‫このコールバック関数は､ ヒットイベントに対して正しいシグネチャを持つ必要があり､ つまり入力パラメータリストが非常に特殊である必要があります｡
‫最初の入力パラメータはyouプリミティブコンポーネントポインタの型でなければならず､ それをhit compと呼ぶ｡
‫これは､ 打撃を与える部品です｡
‫今回は､ 投影メッシュを物にぶつけるようにします｡
‫次のパラメータは､ Other Actorと呼ばれるアクターポインタです｡
‫これはやられた役者になりそうだ｡
‫次の入力パラメータは､ other compと呼ばれる別のあなたのプリミティブコンポーネントポインタです｡
‫これが当たったもう一つの部品です｡
‫つまり､ 他のアクターの静的メッシュコンポーネントを叩くと､ これがその静的メッシュコンポーネントになるわけです｡
‫次に､ ノーマルインパルスと呼ばれるFベクトルです｡
‫物理シミュレーションをしている場合､ 物理エンジンは衝突に対応してインパルスを適用します｡
‫そして､ このfベクトルは､ そのインパルスの方向と大きさを表しています｡
‫そして最後に､ 入力パラメータとして const F hit result という型があり､ これは const reference で､ hit という名前になっています｡
‫そのため､ ヒットしたときに､ そのヒットに関するより多くの情報を含むヒット結果にアクセスすることができます｡
‫さて､ これをデリゲートにバインドしているので､ U関数でなければなりません｡
‫だから､ 私たちはあなたと一緒にこれをマークする機能です｡
‫さて､ あなたは自分の機能を熟知しているはずです｡
‫プロパティと同じように､ 変数ではなく､ 関数に適用されます｡
‫とても大切なことですね｡
‫コールバックは､ u関数でなければ動作しません｡
‫これで､ 関数の宣言ができました｡
‫それでは､ 関数を定義してみましょう｡
‫そこで､ 投射材に戻ります｡
‫CP tick関数の直下に､ この関数を定義しましょう｡
‫この関数にボディを与え､ クラス名を関数名の直前に置くと､ コールバック関数ができあがります｡
‫では､ このヒットした関数をデリゲートにバインドする準備ができましたので､ begin playでこれを行う必要があります｡
‫コンストラクタで実行すると､ デリゲートがバインドされないなどの問題が発生することがあるため､ 早期に実行する必要があります｡
‫ということで､ ここでやってプレイ開始です｡
‫では､ 投射メッシュを用意し､ 矢印演算子を使って継承した変数にアクセスします｡
‫コンポーネントヒット時に呼び出されるプリミティブコンポーネントで､ コンポーネントヒット時に機能追加ダイナミックを持っています｡
‫不思議なことに､ オートコンプリートはadd dynamicには効かないので､ 関数名を全部入力する必要があります｡
‫これは､ コンポーネントがヒットしたときにコールバックをバインドするために使用する関数で､ その関数を呼び出しリストに追加します｡
‫まず､ ユーザーオブジェクトが必要ですが､ これは関数をバインドするクラスであるためです｡
‫そこで､ operatorのアドレスとfunction a projectile on hitを使用することにします｡
‫これで関数の結合が完了し､ ヒットイベントを生成する準備が整いました｡
‫ここで､ UEEログでテストしてみると､ log temp warningを使うことができます｡
‫そして､ テキストについては､ 単純にヒットで言えばいいのです｡
‫そして､ 出力ログにこのように表示されれば､ オンヒット関数が呼ばれたことが分かります｡ これをコンパイルしてみましょう｡
‫そこで､ ここに出力ログを開いています｡
‫再生ボタンを押して弾を発射し､ そこにhit is calledのログメッセージが表示されます｡
‫これが効いているんですね｡
‫さて､ 余談ですが､ BP projectileに入り､ 詳細パネルでprojectile meshを選択すると､ collisionセクションまでスクロールすることができます｡
‫そしてここでは､ コリジョン プリセットがすべてのダイナミックをブロックするように設定され､ コリジョン有効がこの設定コリジョン有効クエリと物理に設定されていることがわかります｡
‫ヒットイベントには必要です｡
‫ヒットしたイベントを問い合わせることができるようにする必要があります｡
‫そしてもちろん､ 物理によって､ 物理エンジンが投射物のメッシュに作用するようになっています｡
‫さて､ on hit 関数で on component hit delegate にバインドし､ 巨大なログを配置して動作していることを確認したところで､
‫on hit 関数の入力パラメータのいくつかを理解するために､ この関数をもう少し詳しく調べてみたいと思います｡
‫そこで､ オンヒット機能で､ YOUIのログをいくつか追加してください｡
‫これらの入力パラメータのうち､ いくつかの名前をgit name関数を使って表示してほしいのです｡
‫YUIのログを使って､ ヒットしたコンプ､ 他のアクター､ 他のコンプの名前を出力して､ ヒットしているこれらのオブジェクトの名前がわかるようにしてほしいです｡
‫パーセントSE形式を使うのであれば､ Eログテキストマクロでtheを指定します｡
‫例えば､ 他のアクターの名前を取得するには､ 他のアクター､
‫get nameを呼び出し､ アスタリスクを先頭に置いて､
‫Cスタイルの文字列を返します｡
‫そこで､ ビデオを一時停止して､ Yui log in our on hit functionを使って､ ヒットしたコンプ､ 他のアクター､ 他のコンプの名前を現在表示するようにします｡
‫なるほど｡
‫で､ ここのプロジェクタイルCPで､ ここのyou logを使います｡
‫そこで､ Yui logを使っているこの行をコピーして､ 文字列にはhit comp percent sと言い､
‫テキストの直後にはhit comp get nameと言い､ このアスタリスクはF文字列からCスタイル文字列に変換するために必要です｡
‫今度は同じ行を使いますが､ テキストを「other actor」に変えて､ 今度は「other
‫actor」に名前を付けて呼びます｡
‫そして最後に､ 他のコンプの呼び出しをプリントして､ 他のコンプに名前を入れてもらうんです｡
‫では､ コンパイルしてエディタに戻り､ 再生ボタンを押して弾丸を発射し､ これを確認してみましょう｡
‫ヒットコンプは投射メッシュであることがわかります｡
‫このコンポーネントは､ デフォルトのサブオブジェクトを作成する際に､
‫このコンポーネントに割り当てた名前を使っていることがわかります｡
‫だから､ その名前が使われている状況の一つです｡
‫ここで､ other actor flaw underscore zeroと書かれているのがわかると思います｡
‫そして､ この欠陥となる静的メッシュのアクターは､ flowアンダースコア・ゼロという名前を持っているからです｡
‫エンジンはアクターやコンポーネントの内部名称の末尾に数字を付けることがありますが､ 他のカンプをプリントアウトするときにも同じことが起こっているのがわかると思います｡
‫flaw static mesh actor は static mesh component を持ち､ その名前は static mesh component zero です｡
‫これで､ ヒット時のコールバック関数に入力されたパラメータについて､ もう少し詳しい情報が得られるようになりました｡
‫そして､ ヒット・イベントに反応して何かをしたい場合､ C++でそれらのオブジェクトにアクセスできるので便利です｡
‫まとめると､ ヒットイベントとそれがマルチキャストデリゲートとして実装され､ それらがどのように機能するかについて学びました｡
‫On Hit と呼ばれる関数を作成し､ 投射物メッシュがプリミティブコンポーネントクラスから継承した on
‫component hit デリゲートにバインドしています｡
‫しかし､ このコールバック関数があれば､ 発射体を破壊するなどのロジックをこの関数内に配置することができるので､
‫簡単に破壊できることがわかりました｡
‫ですから､ それは今後の動画で扱います｡
‫とりあえず､ これまで学んだUnreal Engine C++の中でもより複雑な分野の一つなので､ 自分をほめてあげてください｡
‫次の動画でお会いしましょう｡