‫こんにちは､ ようこそ｡
‫この講義では､ 乱雑になったブループリントを関数にきちんと整理して､ ブループリントのイベントグラフで起こっていることを簡単に読み､
‫理解できるようにします｡
‫さっそく､ その方法を見てみましょう｡
‫さて､ イベントグラフを拡大してみると､ 非常にノイズが多くなってきていることがわかります｡
‫また､ 何にも接続されていないノードがいくつか見えます｡
‫削除する予定のgetノード､ アセット､ M0ノードがありますが､ 非常にノイズが多くなっているのがわかると思います｡
‫何が何だかわからなくなってきた｡
‫さて､ 一般的な解決策としては､ 「このノードのブロックは､ すべて発射体を生成するためのものだ」というものがあります｡
‫だから､ これらを選択することができるのです｡
‫Cキーを押すと､ コメントブロックと呼ばれるブロックがこの周囲に配置されるんだ｡
‫そして､ spawn projectilesと入力すると､ そのコードのブロックが何をしているのかがわかるんです｡
‫確かにそれは､ コードを整理する一つの方法です｡
‫しかし､ 私の考えでは､ これは最良の方法ではなく､ 関数と呼ばれるより良いツールを手に入れることができました｡
‫では､ 機能とは何でしょうか｡
‫機能とは､ 設計図のブロックを実行し､ ゲームに何かをさせることです｡
‫Unreal Real が提供する多くのノードは､ 実はすでに関数なのです｡
‫だから､ これらに遭遇したのです｡
‫例えば､ スポーンアクターの発射ノードをズームインすると､ これが関数になります｡
‫インパルスの追加を見ると､ これは､ これらのノードのほとんどすべてに対する関数です｡
‫実行ピンを持たず､ 青色でもない､ 前方アクティブベクターの取得なども関数で､
‫左上の小さな f 記号は関数の略です｡
‫関数も自分たちで作れますし､ 本当に簡単です｡
‫Blueprintでは｡
‫これにより､ コードのブロックを再利用することができます｡
‫コメントだとコピー＆ペーストしなければならないので､ コメントよりいいわけです｡
‫一方､ 関数は､ 1つのコードのブロックを複数の使用場所で共有することができます｡
‫では､ このようなものをどのようにコードのブロックにするのか見てみましょう｡
‫まあ､ コメントブロックは削除すればいいんですよ､ まず､ その必要はないと思うので｡
‫代わりに､ get playerからadd impulseまでのすべてのノードを選択し､ 右クリックしてcollapse
‫to functionを選択します｡
‫そして､ 新しいブロックを作成し､ 以前あったノードをすべて置き換えるのです｡
‫では､ この関数に名前を付けます｡ 左側のペインに表示されているのがそれです｡
‫ブループリント・ペインの関数セクションに新しい関数が作成され､
‫自動的に名前が変更されるように選択されています｡
‫そして､ コードというのは基本的にコミュニケーションがすべてですから､ プログラムにおいて良いネーミングは絶対に欠かせません｡
‫自分たちが書いたものを理解できるように､ 自分たちとのコミュニケーションを図っているのです｡
‫これからの自分たちとのコミュニケーションを考えているのです｡
‫このプロジェクトに戻ったとき､ なぜそのように書いたのか､ 忘れてしまっていることがあります｡
‫また､ チームで仕事をする場合､ 他のメンバーともコミュニケーションを取ろうとしますよね｡
‫コードの品質を測る良い指標は､ 1分あたりの何という数字かという説があります｡
‫もしあなたがコードを読んでいて､ 1分間に50回も「なんだこりゃ」と思うのなら､ それはかなり悪いコードです｡ もしあなたがコードを読んでいて､
‫1分間に1回か2回「なんだこりゃ」と思うだけなら､ それはおそらくかなり良いコードで､ あなたは常にある程度ヘックスを取得しようとしているのです｡
‫だから､ その数を減らすために､ 機能を絞っているんです｡
‫重要なのは､ 私たちは機能を動詞で呼ぶ傾向があることです｡
‫このルールには後ほど説明する例外がありますが､ たいていの場合､ 関数は何かをするものです｡
‫もし､ この機能をどう名付けるか迷ったら､ チームで仕事をしているのであれば､ 他の誰かに相談して､
‫どんな名前がいいと思うか､ どんなことが納得できるかを聞けばいいわけです｡
‫問題に染まってしまって､ どう話せばいいのか思いつかないということはよくありますよね｡
‫では､ この弾丸を発射する関数を作ったとき､ 私のコードはどこに行ってしまったのでしょうか？
‫さて､ この関数が実際にどのように実装されているのか､ その詳細に戻るには､ イベントグラフでそれをダブルクリックするか､ My Blueprintsタブでそれをクリックするか､
‫My Blueprintsタブでそれをダブルクリックするか､ いずれかの方法で行います｡
‫イベントグラフ・タブに戻ることもできますし､ 「Spawn projectile」タブに飛び込んで､
‫この関数だけを表示させることもできます｡
‫そして､ ここに新しいノードがあるのがわかります｡ この小さな紫色のノードが､ この関数へのエントリポイントです｡
‫これは､ 機能が始まったらこうしようというものです｡
‫あくまで入り口です｡
‫この関数が呼ばれるたびに､ そのノードがトリガーとなり､ 関数内の残りのすべてのノードがトリガーされます｡
‫そこで､ イベントグラフに戻ると
‫ズームアウトして､ ノードを少し寄せるとか｡
‫これで､ ノードグラフがとても小さくなり､ 見やすくなりました｡
‫機能を抜いたり､ モノを入れ替えたりする候補は､ ここにも2つほどあると思います｡
‫そのひとつが､ 弾薬をプリントアウトしているところでしょう｡
‫ですから､ この場合､ 弾薬の印刷は2箇所で行うものです｡
‫ビギンプレイでもそうだし､ スポーンプロジェクタイルでもそうだ｡
‫もうひとつは､ 弾薬を減らしていくような機能で､ これは弾薬の減少を表す関数に置き換えることができます｡
‫そこで､ 課題を出す直前に､ 問題が複雑になりそうなので､ spawn projectileの後にあるconversionノードとprint
‫stringノードを削除しておきたいと思います｡
‫上の機能をコピーして､ 2つとも全く同じに見えるようにしたいのですが｡
‫Begin Playから3つのノードをコピーして下にペーストし､ 実行ピンを接続すると､
‫まったく同じノードセットと同じ機能が2つの間に存在し､ これを関数に抽出する際に混乱がないことがわかります｡
‫そこで､ もう少し機能を増やすことにチャレンジしてみたいと思います｡
‫最初にやっておいた方がいいのは､ 減少弾薬です｡
‫つまり､ 弾薬の減少に関わる3つのノードを取り出し､ それを関数に抽出して名前をつけているのです｡
‫そして､ 2つ目はプリント用弾薬です｡
‫そこで､ 弾薬の取得､ 変換､ 印刷の機能を1つの関数に抜き出すことになるわけです｡
‫また､ 弾薬を印刷するサイトが2つあるので､ そのうちの1つを削除して､
‫代わりに関数を持ってきた方がいいかもしれません｡
‫そして最後に､ いくつかのウェルカムメッセージ､ ウェルカムメッセージノードの出力があります｡
‫それをプリントに抽出することができます｡
‫ウェルカムメッセージの機能もあります｡
‫ビデオを一時停止して､ 試してみてください｡
‫なるほど｡
‫お帰りなさい｡
‫そこで､ まず減少弾を抽出することにします｡
‫そこには3つのノードが関係しているわけです｡
‫この関数を右クリックして､ 「Decrease Ammo（弾薬の減少）」と名付けます｡
‫つまり､ 弾薬を発射し､ 弾薬を減らし､ そして弾薬をプリントしているのです｡
‫そこで､ 3つのノード､ get convertとprint stringを取り､ 右クリックでcollapse to functionして､
‫この1つのprint ammoを呼び出すことにしましょう｡
‫この機能は2箇所で繰り返されているので､ begin playでこの機能を実行している箇所を削除し､
‫関数リストからprint ammoをドラッグして実行ピンを接続し､ print stringの後に実行されるようにします｡
‫そこで､ 最後に作りたいのが､ print welcome messagesと名付けた関数です｡
‫そこで､ print strings after being in play collapse to functionを選択し､ print welcome
‫messagesと呼ぶことにします｡
‫このノードで､ すべてのノードを並べ替えると､ 1つの画面いっぱいに表示されたすべての内容をはるかに読みやすくすることができます｡
‫ゲームの機能が1つの画面に収まり､ 同じような抽象度と理解度でうまくまとめられているため､
‫より理解しやすくなっているのがおわかりいただけると思います｡
‫そしてこれは､ 何をするのかを説明するためのコメントや文書を必要としないコードであるため､ セルフ・ドキュメント・コードと呼ばれるものである｡
‫ただ､ 英語のように読めます｡
‫素晴らしい内容です｡
‫それでは､ 次回の講義でお会いしましょう｡