【Unity】Fungusでゲーム制作(5) uGUIとの連携でアイテム欄を作る

Fungusの基本的な使い方に関しては[第1回](https://qiita.com/Kirikabu_ueda/items/bfc6e086d408b1cba34b)の記事で解説しておりますので、まだの方はそちらからお読み下さい。

[前回](https://qiita.com/Kirikabu_ueda/items/af8c5eb4f698b70b0eca)、コレクションを利用し、所持しているアイテムをリストとして管理できるようになりました。次はuGUIと連携するためのコマンドを使い、アイテム欄のUIを作ります。
このページでは**画面下端にアイテムを入れるボタンを並べ、クリックするとアイテムの説明文が出る**、というものを作ることにします。
#ボタンを配置する
まずはガワから用意してみましょう。Unity全体のメニューから**「GameObject」→「UI」→「Button」**を選んでuGUI製のボタンを作ります。
ここでHierarchyビューに注目です。もしすでにステージ（第1回参照）を作っているなら、その中の**Canvasというものの下にボタンができる**と思います。
![11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/402f1996-d1e6-806c-a160-03f5dc05dd58.png)
uGUIでは**Canvasという下敷きが必ず用意され、その上にボタンなどの部品を置いていくことでUIを作る仕組みになっています。**これらは初期状態ではカメラをどこに動かしても同じ場所に表示されるように設定されているため、UIとして使うことができるのです。そしてすでにCanvasがある場合、uGUIの部品を追加するとそこに勝手に入れてくれるようになっています。

しかし、ステージ用のCanvasにボタンを置くとどうも動かないようです（原因についてはまだ調べています……）ので、独自にCanvasを作ってそこへボタンを配置することにしましょう。**「GameObject」→「UI」→「Canvas」**で作れます。
![12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/5d7ae8f4-1de0-16cb-47ca-a41ed305da36.png)
独自のCanvasを作り、7つほどボタンを並べました。ボタンにはデフォルトで**文章（Text）**がついてきます。これをアイテム名の表記に使います。
（ここで、それぞれのボタンのTextの名前が同じになっているはずなので、変えておいた方がよいです。後で混乱のもとになるので……）
#ボタンの表記を変更する
続いて、アイテムを拾ったり手放したりした時に各ボタンの表記を変更します。先ほど、アイテムをコレクションの形で管理することにしましたから、例えば下図のように**ボタンにも順に0からの番号を振って、アイテムのコレクションと1対1で対応させる**……とすれば上手くいきそうですね。
（「ボタンもコレクション化する」わけではないことに注意して下さい。あくまで便宜上番号を振るというだけです）
![13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/c9533da7-a36c-3520-02e1-8e2d77b24275.png)
さっそく処理を作ってみましょう。新しいブロックを用意し、前回説明したElementコマンドでアイテムコレクション0番目のアイテム名を取り出してみてください。
次はその名前を0番目のボタンにあてがいます。FungusからuGUIのテキストを書き換えるには**UI/Set Textコマンド**を使います。
![13_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/034178e3-cdc9-586a-5abd-6e6f07b7fec9.png)
**Target Text Object欄**に変更したいテキストをあてがい、**Text欄**にその内容を書きます。今回はボタンの中のTextをTarget Text Objectに指定し、Text欄には先ほどコレクションから取り出したアイテム名を入れます。例の変数を文章に埋め込む表記でもいいのですが、**「＜Value＞」**と書かれているところをクリックすると変数のメニューが表示され、選択した変数の中身をそのまま渡せますので、そちらを利用するのもよいでしょう。
コマンド一覧は以下のようになると思います。前回解説したように、そもそもない番号を指定してしまった時のエラーを防ぐ機構も入っています。
![14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/e5161247-4116-c92a-a373-0d03c7cc3038.png)
同様にして、コレクションの1番のアイテム名を1番のボタンに入れる処理、2番のアイテム名を2番のボタンに入れる処理……を作っていきましょう。この時、エクスプローラ（MacならFinder）でやるのと同様に**Shiftキー＋クリックでコマンドをまとめて選択し、その状態でコピペもできる**ので活用して下さい。

さて、この一連の処理はアイテム欄に変化がある度に呼ばれないといけません。アイテムを入手したり捨てたりする度にCallでこのブロックを呼ぶようにもできますが、それだと多分どこかで呼ぶのを忘れてしまうので、いっそ常に呼ばれ続ける状態にしてしまいましょう。BlockのExecute On Event欄を**MonoBehaviour/Update**に指定すれば、毎フレームこのブロックが呼ばれるようになります。
終わったらゲームを起動し、動作を確認してみましょう。
![15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/cbdaaeb3-bbb5-68fe-e41e-5fd1bd9d5b54.png)
#ボタンを押した時にイベントを起こす
最後に、アイテムが入っているボタンを押すと説明文が表示されるようにしてみましょう。
まずはやはりガワからです。Unityのメニューの**「GameObject」→「UI」→「Panel」**で説明文の土台になるパネルを作ります。
しかしこのままだとゲームを開始していきなりパネルが表示されてしまいますので、初めは隠しておくために、**パネルを選択してInspectorビューの左上隅あたりにあるチェックを外しておきます（非アクティブ化）。**
続いてパネルの中に**「GameObject」→「UI」→「Text」**で説明文になるテキストと、**「GameObject」→「UI」→「Button」**でパネルを閉じるためのボタンも作っておきます。
![16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/22dc989d-8e87-f7c0-4924-42e091f2cc6b.png)
中身作りに進みます。フローチャートで新しいブロックを作って条件を**UI/Button Clicked**にします。これは指定されたボタンが押された時に起動する条件で、選択すると出てくる**Target Button欄**にそのボタンを指定します。ここではとりあえず0番目のボタンを指定します。

条件も決まったのでコマンドの組み込みに移ります。まずは先ほど非アクティブ化したパネルをもとに戻し、再び画面に表示させましょう。**UI/Set Activeコマンド**を使います。
![17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/2948cea0-6926-5cfd-46d6-c37b8af2b5ba.png)
**Target Game Object欄**にアクティブかどうかを変更したいもの（UIに限らずGameObjectなら全てOK）を指定し、**Active State欄**でアクティブにするか非アクティブにするかを決めます。ここではチェックを入れておきましょう。

次はパネルの中の説明文を書き換えます。アイテムコレクションの中からボタンと対応する番号のものをElementコマンドで取り出して、その種類に応じてIfコマンドで分岐させ、Set Textコマンドでパネルのテキストに説明文を書き込む……というのでいけるでしょう。
ですがアイテムのボタンはいくつもあり、全てが同じ処理をする必要があるので、上記の処理をそれぞれのボタンのブロックに対してコピペするのでは効率が悪いです（例えば一つアイテムを追加するとなったら全部のブロックを直さないといけませんね）。そこで、**アイテムの種類に応じた説明文を書き込むブロックを別途作り、各ボタンからはそれをCallコマンドで呼び出すだけ**という形にしたいと思います（下図）。
![18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/9c087415-d796-a50e-1724-0c4172615104.png)
Callコマンドで呼び出すだけ、と書きましたが、**実際はボタン側でCallする前にアイテムの種類を変数に入れておく必要があり、Callされた説明文書き込みブロックの側でその変数を参照することになります**（Callする際になにかデータを渡すということはできないのでそうするしかないようです）。以下のような感じですね。
![18_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/3a6a26b8-8dd4-bcf5-e598-dd03e5467e05.png)
上記のようにElementコマンドでボタンに割り振った番号のアイテムをコレクションから取ってくるか、あるいは今回ボタンのTextにアイテム名を指定しているのでそれを使うのもアリでしょう。**UI/Get Textコマンド**でTextに指定した文章を取得できます。
![19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/ecbe8baa-fb7e-74e5-c8c5-d9bf91704377.png)
**Target Text Object欄**で対象のTextを、**String Variable欄**で取得した文章を入れる変数を指定します。

いずれにせよボタンの方のブロックはこれでOKですので、今度は説明文を書き込むブロックを作ります。
説明文ブロックではボタンの方でアイテム名を入れた変数（上記のコマンド一覧ではTempStringというのに入れています）に応じて分岐させ、アイテムに応じた文章をSet Textコマンドで説明文パネルのテキストに書き込む、という形で組んでみます。
今回は分岐が何通りにも及ぶので**Else Ifコマンド**を使うと良いです。これは名の通りElseとIfが一体になったコマンドで、Ifで指定した条件に当てはまらない時にさらに条件をかませて分岐させるということができます。使い方はIfコマンドに準じます。
![20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/dfb654d2-2116-37de-de04-1e2bd5e87d56.png)
実際に組むと以下のようになると思います。
![21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/008ed22d-aeef-309a-3421-7402ac8eee85.png)
最後に説明文のパネルを閉じるボタンに機能をもたせましょう。新しいブロックを作り、UI/Button Clicked条件を指定してTarget Button欄にパネルを閉じるボタンをあてがいます。Set Activeコマンドを追加して説明文のパネルを非アクティブ化するようにします。
![22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/2f804ce6-6efa-8b8a-d420-237547747548.png)
長くなりましたがこれでようやくアイテム欄も完成です。さっそく試してみましょう。
![23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/63319/495a2c45-367f-81e8-7407-918bfb50100b.png)
前回はコレクション、今回はuGUIとの連携と、2回にわたってアイテム欄の実装に必要な処理について解説してきました。
今回、特にプログラミングに触れた経験がある方は回りくどいことをしている気が……と思われたかと思います（特にアイテムコレクションの中身をボタンに反映する所とか）。このような時により効率のいいやり方をするには自らプログラムを書き、（現状の）Fungusのコマンドにない処理を追加していく必要があります。それでも全くゼロからゲームを作るよりは簡単なので気負いすぎることはありませんし、今はとりあえず先にゲームを完成させることを目指した方がよいでしょう（既存のコマンドだけで作っているうちに「こんな機能があったらいいのに」というのが出てくるはずなので、それを実装することを目標にプログラミングを学べばよいと思います）。

次回はプレイ時間が長いゲームを作る時のために、セーブ・ロード機能について解説する予定です。

[第6回に進む](https://qiita.com/Kirikabu_ueda/items/fbd941ee6271f0552d6d)