２Ｄタップシューティングゲーム　発展２７ - i-school

　バレット選択ボタンのオン・オフの切り替えを、ボタンのコストと Exp の現在値とを比べて確認して、切り替えするよう制御を行います。
Exp の現在値がバレット選択ボタンのコストの値を上回ると、そのバレット選択ボタンが押せるように制御します。

　バレット選択ボタンを押すと、その時点でも再度コストと Exp の確認が入り、Exp の値がコストを満たさない、選択していないバレット選択ボタンがある場合には
そのバレット選択ボタンは押せない状態に切り替わるように制御します。

＜実装動画①　バレット選択ボタンを押すと、ボタン上に表示されているコスト分の支払いが発生し、Exp より減算されて、Exp の横にフロート表示が生成される＞

動画ファイルへのリンク

＜実装動画②　ゲージが残っているバレットは切り替えてもコストの支払いは発生しない。ゲージがなくなると再度コストの支払いが発生する＞

動画ファイルへのリンク

　以下の内容で順番に実装を進めていきます。

発展２７　－バレット選択用ボタンのコストの支払い処理とボタンのオン・オフ制御の連動－

５４．BulletSelectManager スクリプト、BulletSelectDetail スクリプトを修正し、バレット選択ボタンを押した際にコストとして Exp の値を更新し、バレットのコストを確認し、ボタンが押せるようになるか判定を行い、ボタンの制御を行う

　新しい学習内容は、以下の通りです。

　・if文の条件式に戻り値を持つメソッドを利用する場合の実装例
　・引数に条件式を利用する方法
　・プロパティを自作する

５４．BulletSelectManager スクリプト、BulletSelectDetail スクリプトを修正し、バレット選択ボタンを押した際にコストとして Exp の値を更新し、バレットのコストを確認し、ボタンが押せるようになるか判定を行い、ボタンの制御を行う

１．設計

　コストと Exp によるボタンのオン・オフ切り替え処理のロジックが実装出来たら、次は、コストの支払い処理と、それに関連する処理を考えていきます。

　押せるようになったバレット選択ボタンの押すことで設定されているコスト分の Exp を減算するようにします。
Exp の値は GameData スクリプトが管理していますので、EnemyController でも利用しているメソッドを活用しましょう。
コストの設定値はマイナスではありませんので、引数でコストを渡す際にはマイナスをつけるか、受け取ったメソッド内でマイナスをつけることを忘れないでください。
誤って両方の処理でマイナスをつけてしまうと加算処理になりますので注意します。

　このとき大切なことは、この処理を各ボタンで実装せずに、BulletSelectManager スクリプトにおいて処理を実装する設計にすることです。

　コストを支払うということは、Exp の現在値がマイナス方向に更新されます。
そのため、今回選択していないバレット選択ボタンのコストの値と Exp の値を再計算しないとなりません。
なぜならば、コストが足りない状態なのにボタンが押せてしまう状態が発生してしまうためです。

　また画面上に表示する Exp の値も更新しなければなりませんので、これらの処理をまとめて
BulletSelectManager スクリプト側に用意しておいて、そちらでコストの支払いと、これらの関連処理を実行してもらうように考えてみてください。
ボタン(BulletSelectDetail スクリプト)側では、その用意したメソッドにコストの値を引数として渡して呼び出すようにする、ということです。

　この処理を実装することで、コストを支払った際に Exp の現在値を元に再度ボタンのオン・オフの切り替えが行われるため、
現時点でコストの値よりも Exp の値が低くなっているバレット選択ボタンについては押せなくなる制御が働きます。
　
　一度コストを支払って発射可能になったバレットはゲージが残っている間は再度ボタンを押して切り替えが可能で、コストを支払うことなくバレットが発射できます。
ゲージがなくなり、再度、ボタンが押せるようになった場合には、そこでまたコストの支払いが発生します。

２．BulletSelectManager スクリプトを修正する

　今回の処理については、BulletSelectManager スクリプトと BulletSelectDetail スクリプトの両方で
お互いの処理を呼び出す処理を実装するため、両方の実装が終了しないとエラーが出る状態になります。

　if 文の条件式として、戻り値を持つメソッドを実行して取得する実装例を提示しています。

　設計でも説明しましたが、各バレット選択ボタンのコストの支払いや、UI (Exp の現在値)への表示更新、
またコスト分のフロート表示なども行ってから、再度各バレット選択ボタンのコストと Exp の現在値を確認する処理を実行します。
今回は引数として受け取ったコストの値を、メソッド内でマイナスにして利用しています。

　必要になる制御はどのような内容になるかを考えてロジックを考えて実装を行いましょう。

　BulletSelectDetail スクリプト側に「コストの支払い状態」を管理する変数を用意しますので、
そちらを利用することによって、各バレット選択ボタンのコストの支払い状態が確認できます。
これを利用して、コストの支払い済であればボタンを活性化する処理を、コストと Exp によってボタンのオン・オフの切り替えを行うメソッド内に追加実装します。

　この部分の制御はうまく制御しないと、恐らく予期しない動作しか起こさなくなります。
１つ１つの処理をしっかりと把握してロジックを組みこんでいくことが大切です。

BulletSelectManager.cs

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class BulletSelectManager : MonoBehaviour
{
    [SerializeField]
    private BulletSelectDetail bulletSelectDetailPrefab;　　// BulletSelectDetail スクリプトがアタッチされている、プレファブの btnBulletSelect ゲームオブジェクトをアサインする

    [SerializeField]
    private Transform bulletTran;                           // バレット選択ボタンの生成位置として利用するゲームオブジェクトをアサインする

    private const int maxBulletBtnNum = 4;                  // バレット選択ボタンの最大数。定数として宣言する

    public List<BulletSelectDetail> bulletSelectDetailList = new List<BulletSelectDetail>();      // 生成されたバレット選択ボタンの List

    [SerializeField]
    private BulletDataSO bulletDataSO;                     // BulletDataSO スクリプタブル・オブジェクトをアサインする

    private GameManager gameManager;    　　　　　　　　　 //　変数を追加します。 　


    /// <summary>
    /// バレット選択用ボタンの生成
    /// </summary>
    /// <param name="gameManager"></param>
    /// <returns></returns>
    public IEnumerator GenerateBulletSelectDetail(GameManager gameManager) {

        this.gameManager = gameManager;

        for (int i = 0; i < maxBulletBtnNum; i++) {

            // バレットボタン生成
            BulletSelectDetail bulletSelectDetail = Instantiate(bulletSelectDetailPrefab, bulletTran, false);

            // TODO バレットボタンの設定。また後で引数に変更があります
            bulletSelectDetail.SetUpBulletSelectDetail(this, bulletDataSO.bulletDataList[i]);

            // リストに追加
            bulletSelectDetailList.Add(bulletSelectDetail);

　　　　　　// 0.25 秒だけ処理を中断(順番にボタンが生成されるようにする演出)
            yield return new WaitForSeconds(0.25f);
        }

        // TODO 使用するバレットの情報を初期設定。後程、引数を変更する
        GameData.instance.SetBulletData(bulletDataSO.bulletDataList[0]);
    }

    /// <summary>
    /// すべてのバレット選択ボタンに対して no で照合を行い、装填中と未装填の状態を変更
    /// </summary>
    /// <param name="bulletNo"></param>
    public void ChangeLoadingBulletSettings(int bulletNo) {

　　　　// バレット選択ボタンの List の要素をすべて取り出し、１つずつ順番に処理する
        for (int i = 0; i < bulletSelectDetailList.Count; i++) {

            // この要素のバレット選択ボタンの no の値が bulletNo (選択されたバレット)と同じであるなら
            if (bulletSelectDetailList[i].bulletData.no == bulletNo) {

                // 装填中状態にする
                bulletSelectDetailList[i].ChangeLoadingBullet(true);

                Debug.Log("装填中のバレットの No " + bulletNo);

　　　　　　// それ以外の no の場合には
            } else {

                // 未装填状態にする
                bulletSelectDetailList[i].ChangeLoadingBullet(false);

                Debug.Log("未装填のバレットの No " + bulletNo);
            }
        }
    }

    /// <summary>
    /// 初期バレットを装填中のバレットとして設定
    /// </summary>
    public void ActivateDefaultBullet() {

        // バレット選択ボタンの List から要素を１つずつ取り出す
        foreach (BulletSelectDetail bulletSelectDetail in bulletSelectDetailList) {

            // 初期バレットの設定があるバレットのデータの場合
            if (bulletSelectDetail.isDefaultBullet) {

                // そのバレットを装填中の状態にする
                bulletSelectDetail.OnClickBulletSelect();

                Debug.Log("初期バレットを装填中のバレットとして設定");

                return;
            }
        }
    }

    /// <summary>
    /// 使用可能バレット選択ボタンの確認と更新
    /// </summary>
    public void JugdeOpenBullets() {

　　　　// 繰り返し利用する情報を変数に代入しておく
        int totalExp = GameData.instance.GetTotalExp();

        // バレットごとに使用可能なEXPを超えているか確認
        foreach (BulletSelectDetail bulletData in bulletSelectDetailList) {

            // ゲーム終了の状態になったら
            if (gameManager.isGameUp) {

                // バレット選択ボタンを非活性化の状態にしてタップできない状態にする
                bulletData.SwitchActivateBulletBtn(false);

                continue;
            }


////*  ここから処理を追加  *////


            // コストを支払っているかどうか、戻り値を持つメソッドを利用して確認する
            if (bulletData.GetStateBulletCostPayment()) {

                // コストを支払い済みの場合、そのバレット選択ボタンはオンの状態にする
                bulletData.SwitchActivateBulletBtn(true);

                continue;
            }


////*  ここまで  *////


            // バレットに設定されているコストの値よりも、Exp の現在値の方が大きいか同じであれば
            if (bulletData.bulletData.openExp <= totalExp) {

                // そのバレット選択ボタンを活性化の状態にしてタップできるようにする
                bulletData.SwitchActivateBulletBtn(true);

            } else {
                // Exp の現在値が超えていないバレット選択ボタンを非活性化の状態にしてタップできないようにする
                bulletData.SwitchActivateBulletBtn(false);
            }
        }
    }


////*  ここからメソッドを１つ追加  *////


    /// <summary>
    /// 選択したバレットのコストの支払いとそれに関連する処理
    /// </summary>
    /// <param name="costExp"></param>
    public void SelectedBulletCostPayment(int costExp) {

        // TotalExp(Exp の現在値) より、選択したバレットのコストを減算
        GameData.instance.UpdateTotalExp(-costExp);

        // 画面の Exp 表示減算後の値に更新
        gameManager.uiManager.DisplayTotalExp(GameData.instance.GetTotalExp());

        // コストの値のフロート表示を生成
        gameManager.uiManager.CreateFlotingMessageToExp(-costExp, FloatingMessage.FloatingMessageType.BulletCost);

        // 使用可能バレットの確認と更新
        JugdeOpenBullets();
    }


////*  ここまで  *////


}

　スクリプトを作成したらセーブします。

３．BulletSelectDetail スクリプトを修正する

　設計に基づいて、処理のロジックを考えて実装を行います。
コストを支払っている状態を確認できるように、専用の変数を作成して管理を行うようにしましょう。
型は任意ですが、bool 型が管理しやすいです。どちらの状態を「コスト支払い済」とするか、自分で設計を考えてから運用してください。

　コストを支払うタイミングとしては、ボタンを押したタイミングが理想だと思いますので、
OnClickBulletSelect メソッド内の TODO 機能の部分に処理を追記していきます。
このとき、コストの支払い有無をきちんと制御できないと、一度支払って発射できる状態になっているのにもかかわらず
再度コスト分引かれてしまうといった不具合が生じやすくなります。

　発射できる時間が終了したバレットは、再度コストを支払うことで、また発射できるようになりますので、
ゲージがなくなったタイミングでコストの支払いを無しの状態に戻すようにしましょう。

　コストの支払い用の変数の管理には、何回も利用することが前提にありますので、メソッドやプロパティを利用することを検討してください。

BulletSelectDetail.cs

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using DG.Tweening;

public class BulletSelectDetail : MonoBehaviour
{
    [SerializeField]
    private Button btnBulletSelect;

    [SerializeField]
    private Image imgBulletBtn;

    [SerializeField]
    private Image imgLaunchTimeGauge;  // バレットを発射できる時間のゲージ

    [SerializeField]
    private Text txtOpenExpValue;

    public BulletDataSO.BulletData bulletData;

    public bool isDefaultBullet; 　　  // 初期バレットかどうか。初期バレットはバレットの発射時間の残り時間に関係なく発射できる

    private BulletSelectManager bulletSelectManager

    private float launchTime;          // バレットを発射できる残り時間

    private float initialLaunchTime;   // バレットを発射できる時間の初期値

    private bool isLoading;            // 選択したバレットを発射できる状態(装填中)のバレットかどうか。true なら装填中で発射できる。装填中の場合には launchTime も減る


////*  ここから変数の宣言を追加  *////


    private bool isCostPayment;        // 現在コストを支払って開放済かどうか。trueならコスト支払い終了


////*  ここまで  *////


    /// <summary>
    /// 初期設定
    /// </summary>
    /// <param name="bulletSelectManager"></param>
    /// <param name="bulletData"></param>
    public void SetUpBulletSelectDetail(BulletSelectManager bulletSelectManager, BulletDataSO.BulletData bulletData) {

        this.bulletSelectManager = bulletSelectManager;

        this.bulletData = bulletData;

        // 画像変更
        imgBulletBtn.sprite = this.bulletData.btnSprite;

        // ボタンにメソッド登録
        btnBulletSelect.onClick.AddListener(OnClickBulletSelect);

        // バレットを選択できない(ボタンを押せない)状態に切り替える 
        SwitchActivateBulletBtn(false);

        // バレットを発射できる時間の設定し、初期値とする
        initialLaunchTime = this.bulletData.launchTime;

　　　　// バレットの発射できる時間を初期値から設定する
        launchTime = initialLaunchTime;

        // バレットの発射できる残り時間のゲージ表示を 0 にして非表示にする
        imgLaunchTimeGauge.fillAmount = 0;

        // バレット選択ボタンを押せるようになるために必要な Exp を表示
        txtOpenExpValue.text = this.bulletData.openExp.ToString();

        // 初期バレット確認
        if (this.bulletData.openExp == 0) {

            // 初期バレット用の設定
            isDefaultBullet = true;

            // 装填中の状態に切り替える
            ChangeLoadingBullet(true);

            // Exp 関連の表示を非表示にする
            txtOpenExpValue.gameObject.SetActive(false);

            // ボタンを押せる状態にする
            SwitchActivateBulletBtn(true);

            // TODO そのほかに設定する処理を追加

        }
    }

    /// <summary>
    /// バレット選択
    /// </summary>
    public void OnClickBulletSelect() {
        Debug.Log("バレット選択");

　　　　// このバレット選択ボタンに設定されている BulletData を GameData スクリプトの currentBulletData 変数に登録し、現在使用中のバレットとする
        GameData.instance.SetBulletData(bulletData);

        // このバレット選択ボタンを装填中に切り替えて、それ以外のバレット選択ボタンの状態を未装填に変更
        bulletSelectManager.ChangeLoadingBulletSettings(bulletData.no);

        // 初期バレット以外のバレットである場合で、まだ選択していない場合(重複タップ防止)
        if (!isDefaultBullet && imgLaunchTimeGauge.fillAmount == 0) {
        
            // バレットの発射できる残り時間のゲージを最大値にして表示する
            imgLaunchTimeGauge.fillAmount = 1.0f;

　　　　    // コストEXP非表示 
            txtOpenExpValue.gameObject.SetActive(false);


////*  ここから処理を追加  *////


            // 選択したバレットのコストの支払いとそれに関連する処理(コストのマイナス補正はメソッド側で行うので、こちらはそのままのコスト値を渡す)
            bulletSelectManager.SelectedBulletCostPayment(bulletData.openExp);

            // コスト支払い済状態にする = 開放条件にてEXPが足りなくても押せない状態にならないようにする
            SetStateBulletCostPayment(true);


////*  ここまで  *////


        }
    }

    /// <summary>
    /// 装填中のバレットを切り替え
    /// </summary>
    /// <param name="isSwitch"></param>
    public void ChangeLoadingBullet(bool isSwitch) {
        isLoading = isSwitch;
    }

    void Update() {

        // 初期バレットは発射できる時間制限なし
        if (isDefaultBullet) {
            return;
        }

        // 装填しているバレットでなければ何もしない
        if (!isLoading) {
            return;
        }

        // 発射できる残り時間を減らす
        launchTime -= Time.deltaTime;

        // 残り時間とゲージを合わせる = 残り時間がなくなったら、ゲージも見えなくなる
        imgLaunchTimeGauge.DOFillAmount(launchTime / initialLaunchTime, 0.25f);

        // 発射できる残り時間がなくなったら
        if (launchTime <= 0) {
            launchTime = 0;

            // 初期バレット以外のバレットを初期状態に戻す
　　　　　　InitialzeBulletState();
        }
    }

    /// <summary>
    /// 初期バレット以外のバレットを初期状態に戻す
    /// </summary>
    private void InitialzeBulletState() {

        // 装填中の状態を未装填の状態にする　=>　このバレットの発射できる時間が終了したため
        isLoading = false;

        // 初期バレットを装填中のバレットとして設定　=>　このバレットの発射できる時間が終了したため
        bulletSelectManager.ActivateDefaultBullet();

        // 発射時間の初期化
        launchTime = initialLaunchTime;

        // 開放に必要なEXPを表示
        txtOpenExpValue.gameObject.SetActive(true);


////*  ここから処理を追加  *////


        // コスト未払いの状態に戻す
        SetStateBulletCostPayment(false);

        // 選択可能なバレットの確認
        bulletSelectManager.JugdeOpenBullets();


////*  ここまで  *////


    }

    /// <summary>
    /// バレット選択ボタンの活性化/非活性化の切り替えの更新
    /// </summary>
    public void SwitchActivateBulletBtn(bool isSwitch) {
        btnBulletSelect.interactable = isSwitch;
    }


////*  ここからメソッドを２つ追加  *////


    /// <summary>
    /// コスト支払い状態の確認
    /// </summary>
    /// <returns></returns>
    public bool GetStateBulletCostPayment() {
        return isCostPayment;
    }

    /// <summary>
    /// コスト支払い状態の更新
    /// </summary>
    /// <param name="isSet"></param>
    public void SetStateBulletCostPayment(bool isSet) {
        isCostPayment = isSet;
    }


////*  ここまで  *////


}

　スクリプトを作成したらセーブします。

４．応用＜isCostPayment 変数のプロパティを作成する＞

　GetStateBulletCostPayment メソッドと SetStateBulletCostPayment メソッドの代わりに、
isCostPayment 変数のためのプロパティを作成して、この２つのメソッドと同じ働きをする処理を実装してみてください。

<= クリックすると開きます。

    // isCostPayment のプロパティ
    public bool IsCostPayment
    {
        set {
            isCostPayment = value;
        }
        get {
            return isCostPayment;
        }
    }

５．ゲームを実行して動作を確認する

　スクリプトの修正が済んだら、処理の流れを確認してください。
コストの支払いに合わせてボタンが制御されることになりますので、どの状態になったら、どのオブジェクトが、どのように制御されているのか正常であるのか、
それを自分で把握できていることが大切になります。何故ならば今後も含めて、様々な処理の修正を行うには、処理の流れをつかんでいる必要があるためです。

＜実装動画①　バレット選択ボタンを押すと、ボタン上に表示されているコスト分の支払いが発生し、Exp より減算されて、Exp の横にフロート表示が生成される＞

動画ファイルへのリンク

　バレットコストの支払いに合わせてボタンの制御処理と、Exp 上にフロート表示が生成されていれば制御成功です。
フロート表示の色は青い色の数字になっていて、マイナス表記がついていれば制御成功です。

　一度コストを支払っているバレットのボタンは、ゲージが残っている間は再度ボタンを押して切り替えが可能で、コストを支払うことなくバレットが発射できます。
ゲージがなくなり、再度、ボタンが押せるようになった場合には、そこでまたコストの支払いが発生します。
その場合には、コストの支払いがあることを伝える意味も含めて、再度、コストの値がボタン上に表示されるようになります(ゲージがある場合には、コストの値は消えていることがわかります)。

＜実装動画②　ゲージが残っているバレットは切り替えてもコストの支払いは発生しない。ゲージがなくなると再度コストの支払いが発生する＞

動画ファイルへのリンク

　以上でこの手順は終了です。

　次は　発展２８　ーバレットの種類による性能変更の追加ー　です。