３Ｄレールガンシューティング　手順２０

　現在使用している武器の情報をゲーム内に実装できましたので、これを利用し、次は武器の切り替え機能の実装を行います。

手順２０ー使用する武器の切り替え機能ー

＜学習内容＞

　・オブジェクト初期化子

設計

　使用している武器の情報を複数管理できるように処理を修正し、
その中のどの武器を利用しているのかを特定して制御することにより、武器の切り替え機能を実装します。

　複数の武器の情報については、List により管理を行うようにします。
最初から取得できる武器の数が決まっている場合には配列でも構いませんが、ゲームの進行状況により、
ゲーム内で入手したり、なくなったりすることを考慮するならば、可変型で管理できる List の方がより使いやすいためです。

　List を管理するクラスとして、シングルトンデザインパターンの GameData クラスを新しく作成します。
シングルトンクラスにすることにより、多くのクラスからアクセスが自由に行える環境にしておくことで
武器の入手や武器の切り替えの処理を実行しやすくなります。

GameData スクリプトを作成する

　シングルトンデザインパターンで作成します。

　WeaponData 型の List の宣言を行い、初期武器の情報、および、ゲーム内で取得した武器の管理も行います。

　取得した武器を List に追加するためのメソッドも用意しておき、武器の取得イベント時には、
こちらのメソッドを実行して武器を List に追加することで武器を取得したことにします。

GameData .cs

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

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

public class GameData : MonoBehaviour {

    public static GameData instance;

    [Header("所持している武器の登録用リスト")]
    public List<WeaponData> weaponDatasList = new List<WeaponData>();


    void Awake() {
        if (instance == null) {
            instance = this;
            DontDestroyOnLoad(gameObject);
        } else {
            Destroy(gameObject);
        }
    }

    /// <summary>
    /// 武器データの登録
    /// </summary>
    /// <param name="weaponData"></param>
    public void AddWeaponData(WeaponData weaponData) {
        weaponDatasList.Add(weaponData);

        Debug.Log("武器追加 : " + weaponData.weaponName);
    }
}

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

GameData ゲームオブジェクトを作成し、GameData スクリプトをアタッチする

　ヒエラルキーの空いている場所で右クリックをしてメニューを開き、Create Empty を行います。
新しいゲームオブジェクトが作成されますので、名前を GameData に変更し、作成した GameData スクリプトをアタッチします。

　インスペクターの設定は不要ですので、正常にアタッチされていることを確認しておいてください。

　以上でこのゲームオブジェクトは完成です。

WeaponChanger スクリプトを作成する

　武器を交換する機能を制御するためのクラスを作成します。

　任意のボタンを押すたびに武器が１つずつ切り替わり、最後の武器までいったら
また最初に武器に切り替わるようにしておきます。

　またゲーム開始当初は武器が１つしかないため、その場合には武器の切り替えのボタンを押しても
武器が切り替わらないようにする制御も合わせて実装しておきます。

　スクリプトに処理を実装する場合、今回の場合であれば、切り替えの処理を実装するにあたり、一方向の切り替えなのか、双方向への切り替えなのか、
切り替える対象の武器がない場合にはどうするのか、といったように、想定される挙動について、すべてを網羅する機能をスクリプト内に記述しておく必要があります。

　そういった意識をもって設計を行えるようにしておくことが大切です。

WeaponChanger.cs

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

using UnityEngine;

/// <summary>
/// 装備している武器の交換用クラス
/// </summary>
public class WeaponChanger : MonoBehaviour {

    public int currentWeaponNo;

    [SerializeField]
    private PlayerController player;


    void Update() {
        if (Input.GetKeyDown(KeyCode.L)) {　　//　<=　任意のボタンに設定してください。
            ChangeWeapon();
        }
    }

    /// <summary>
    /// 武器の交換
    /// </summary>
    public void ChangeWeapon() {

        // 初期武器しか所持していない場合
        if (GameData.instance.weaponDatasList.Count <= 1) {

            Debug.Log("初期武器しかないため、交換しない");

            // 武器交換しない
            return;
        }

        currentWeaponNo = ++currentWeaponNo % GameData.instance.weaponDatasList.Count;　　//　<=　☆どういう処理になっているのか、考えてみてください。

        // 武器のデータを更新
        player.ChangeBulletData(GameData.instance.weaponDatasList[currentWeaponNo]);

        Debug.Log("武器交換");
    }
}

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

WeaponChanger ゲームオブジェクトを作成し、WeaponChanger スクリプトをアタッチする

　ヒエラルキーの空いている場所で右クリックをしてメニューを開き、Create Empty を行います。
新しいゲームオブジェクトが作成されますので、名前を WeaponChanger に変更し、作成した WeaponChanger スクリプトをアタッチします。

　インスペクターの確認を行い、Player 変数に PlayerController のアタッチされているゲームオブジェクトをアサインしてください。

　以上で完成です。

PlayerController スクリプトを修正する

　武器切り替え用を補助する機能を持つ UpdateCurrentBulletCountData メソッドを新しく追加します。
このメソッド内では、現在使用している武器の情報を保持しておき、次に同じ武器を使用する機会が来た時に
保持しておいた残弾数を適用できるようにします。同じ武器を重複して登録しないように重複防止の判定も行っています。

　List 内に情報がない場合には使用したことがない武器として判定し、新しく List に追加します。
List 内に情報がある場合には使用したことがある武器として判定し、既存の武器の残弾数を更新します。

　List を利用するためには、using System.Collections.Generic の宣言が必要です。

　この 武器ごとの残弾数の情報を管理を行う ために、新しいクラスとして BulletCountData クラスを作成します。
このクラスは武器１つごとの情報になりますので、複数の武器の残弾数の情報を扱えるように List によって管理を行います。

　また、ChangeBulletData メソッドの TODO の実装を行い、武器を切り替えた際に、残弾数の確認を行う機能を追加します。

　武器を切り替えた際には、こちらの情報を確認し、切り替える前の残弾数を利用できるようにします。
つまり、ＡからＢの武器に切り替えたときには、Ｂの残弾数を利用し、再度ＢからＡの武器に切り替えた際には
保持しておいた切り替える前のＡの残弾数を利用できるようにしています。

　TODO の部分に関しては、どのような処理を追加すれば期待する機能を実装することができるようになるのか、
まずは考えて、実際に実装を行ってみてください。

PlayerController.cs

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

using System.Collections;
using System.Collections.Generic;　　　//　<=　宣言を追加します
using UnityEngine;

/// <summary>
/// プレイヤー情報の管理クラス
/// </summary>
public class PlayerController : MonoBehaviour {

    private int hp;                // 現在のHp値
    private int bulletCount;       // 現在の弾数値

    [SerializeField, Header("最大Hp値")]
    private int maxHp;

    [SerializeField, Header("最大弾数値")]
    private int maxBullet;

    [SerializeField, Header("リロード時間")]
    private float reloadTime;

    [Header("弾の攻撃力")]
    public int bulletPower;

    [Header("弾の連射速度")]
    public float shootInterval;

    [Header("弾の射程距離")]
    public float shootRange;

    [Header("リロード機能のオン/オフ")]
    public bool isReloadModeOn;

    [Header("リロード状態の制御")]
    public bool isReloading;

    [SerializeField]
    private UIManager uiManagaer;

    public int currentWeaponNo;    // 現在使用している武器の番号


    ////*　クラスの宣言を１つ、変数の宣言を１つ追加　*////


    [System.Serializable]
    public class BulletCountData {       // 入れ子クラス

        public int bulletNo;　　　　 // 武器の番号
        public int bulletCount;　　　// 武器の残弾数

        /// <summary>
        /// 残弾数の更新
        /// </summary>
        /// <param name="amount"></param>
        public void SetBulletCount(int amount) {
            bulletCount = amount;
            Debug.Log("残弾数更新");
        }
    }

    public List<BulletCountData> bulletCountDatasList = new List<BulletCountData>();


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


    /// <summary>
    /// 弾数用のプロパティ
    /// </summary>
    public int BulletCount
    {
        set => bulletCount = Mathf.Clamp(value, 0, maxBullet);
        get => bulletCount;
    }

    //HP も同じようにプロパティ化できますが、今回はしていません。挑戦してみてください。


    void Start() {
        // Debug 用
        SetUpPlayer();
    }

    /// <summary>
    /// プレイヤー情報の初期設定
    /// </summary>
    public void SetUpPlayer() {

        // maxHp の設定があるか確認。なければ初期値 10 でセットして hp を設定
        hp = maxHp = maxHp == 0 ? 10 : maxHp;

        // maxBullet の設定があるか確認。なければ初期値 10 でセットして 弾数を設定
        BulletCount = maxBullet = maxBullet == 0 ? 10 : maxBullet;

        // UI にライフ用アイコンを最大HP数だけ生成する
        uiManager..SetPlayerInfo(maxHp);


        // TODO そのほかの初期設定があればここで行う

    }

    /// <summary>
    /// HPの計算と更新
    /// </summary>
    public void CalcHp(int amount) {
        hp = Mathf.Clamp(hp += amount, 0, maxHp);    // プロパティを作成してもいいです

        Debug.Log("現在のHp : " + hp);               // UI で hp が確認できるようになったらコメントアウトします

        // HP 表示の更新
        uiManagaer.UpdateDisplayLife(hp);

        if (hp <= 0) {
            Debug.Log("Game Over");
        }
    }

    /// <summary>
    /// 弾数の計算と更新
    /// </summary>
    /// <param name="amout"></param>
    public void CalcBulletCount(int amout) {

        BulletCount += amout;

        Debug.Log("現在の弾数 : " + BulletCount);      // UI で弾数が確認できるようになったらコメントアウトします

        // TODO 弾数のUI表示更新

    }

    /// <summary>
    /// 弾数のリロード
    /// </summary>
    public IEnumerator ReloadBullet() {

        // リロード状態にして、弾の発射を制御する
        isReloading = true;

        // リロード
        BulletCount = maxBullet;

        Debug.Log("リロード");                         // UI で弾数が確認できるようになったらコメントアウトします


        // TODO 弾数のUI表示更新


        // TODO SE


        // リロードの待機時間
        yield return new WaitForSeconds(reloadTime);

        // 再度、弾が発射できる状態にする
        isReloading = false;
    }

    private void OnTriggerEnter(Collider other) {

        // TODO 敵からの攻撃によって被弾した場合の処理

        // TODO ボスや敵の攻撃範囲を感知しないようにするためにタグでも判定するか、レイヤーを設定して回避する

    }

    /// <summary>
    /// 武器(バレット)の情報を変更して武器切り替え
    /// </summary>
    /// <param name="weaponData"></param>
    public void ChangeBulletData(WeaponData weaponData) {

        // 現在使用している武器の番号を保持
        currentWeaponNo = weaponData.weaponNo;

        // 武器の情報を各変数に設定
        bulletPower = weaponData.bulletPower;
        maxBullet = weaponData.maxBullet;

        reloadTime = weaponData.reloadTime;
        shootInterval = weaponData.shootInterval;
        shootRange = weaponData.shootRange;

        bulletCount = maxBullet;



        ////*　TODO を実装　*////


        // すでに使用したことのある武器である場合
        if (bulletCountDatasList.Exists(x => x.bulletNo == currentWeaponNo)) {

            // 弾数を前回の残弾数にする
            bulletCount = bulletCountDatasList.Find(x => x.bulletNo == currentWeaponNo).bulletCount;
        }


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


    }


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


    /// <summary>
    /// 使用している武器のデータ(武器の番号と残弾数)を記録して更新
    /// </summary>
    /// <param name="weaponData"></param>
    public void UpdateCurrentBulletCountData(WeaponData weaponData) {

        // まだ一度も使用している武器の残弾数を記録していないとき
        if (!bulletCountDatasList.Exists(x => x.bulletNo == currentWeaponNo)) {
            // 新しくデータを作成して、記録
            bulletCountDatasList.Add(new BulletCountData { bulletNo = currentWeaponNo, bulletCount = bulletCount });
        } else {
            // 使用したことがある武器ですでにデータがある場合には、そのデータを見つけて上書きして記録
            bulletCountDatasList.Find(x => x.bulletNo == currentWeaponNo).SetBulletCount(bulletCount);
        }

        // 武器の情報を設定
        ChangeBulletData(weaponData);
    }


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


}
}

＜オブジェクト初期化子＞

　インスタンスしたクラスや構造体を初期化する方法の１つです。
下記の処理内の、Add メソッド内で実行されている処理がクラスをインスタンスし、初期化している部分です。

PlayerControler.UpdateCurrentBulletCountData メソッド

　// 新しくデータを作成して、記録
  currentBulletCountsList.Add(new BulletCountData { bulletNo = currentWeaponNo, bulletCount = bulletCount });

＜上記の処理のうち、この部分がクラスをインスタンスしている部分＞

new BulletCountData { bulletNo = currentBulletNo, bulletCount = bulletCount }

　コンストラクタを持つクラスや構造体がインスタンスされると、コンストラクタ・メソッドが自動的に呼び出されて、初期化の処理が行われます 。
それ以外の方法として、''インスタンスと同時に { }
を利用して、この中でフィールドに定義されている値への代入処理を行うことが可能 ''です。

　この方法による値の代入処理を オブジェクト初期化子 といいます。

　処理の内容は通常の初期化子と同じです。
ここの機能により、クラスや構造体のフィールドに用意している変数に対して、引数の値を代入することによって初期情報を登録します 。

　そのためオブジェクト初期化子とは、下記のような コンストラクタ・メソッドと同じ働きをする ことになります。

＜new CurrentBulletCount が実行されると、コンストラクタが処理される = 初期化＞

    [System.Serializable]
    public class BulletCountData {       // 入れ子クラス

    public int bulletNo;     // 武器の番号
    public int bulletCount;　　　// 武器の残弾数

　　　　public BulletCountData(int no, int value) {  // <=  ここに引数の情報が届く
        bulletNo = no;
        bulletCount = value;
    }
}

参考サイト

MicroSoft
オブジェクト初期化子とコレクション初期化子(C# プログラミングガイド)
https://docs.microsoft.com/ja-jp/dotnet/csharp/pro...

PlayerController スクリプトがアタッチされているゲームオブジェクトの設定を確認する

　PlayerController スクリプトを修正し、新しく List 型の変数を追加していますので、インスペクターから確認しておきます。

　新しく表示されている List 変数は確認だけで、設定の必要はありません。
この List にはゲーム内で武器の切り替えを行ったタイミングで情報が追加・更新されます。
(ゲーム内で動的に変更・追加されていく値になるためです。)

GameManager スクリプトを修正する

　Start メソッド内にある TODO の実装を行い、初期武器の登録処理の追加と、初期武器の情報を設定する処理の修正を行います。

　こちらも PlayerController スクリプトと同じで、TODO の実装内容を見る前に、自分で処理を考えて、出来れば書いてみてください。

GameManager.cs

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

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

public class GameManager : MonoBehaviour {

    [SerializeField]
    private RailMoveController railMoveController;

    [SerializeField, Header("経路用のパス群の元データ")]
    private RailPathData originRailPathData;                      // 後程 List 化して複数のルートを管理できるようにします

    [SerializeField, Header("パスにおけるミッションの発生有無")]  // Debug 用
    private bool[] isMissionTriggers;

    [SerializeField]
    private PlayerController playerController;

    [SerializeField]
    private EventGenerator eventGenerator;

    [SerializeField, Header("ミッションで発生している敵のリスト")]
    private List<EnemyController> enemiesList = new List<EnemyController>();

    private int currentMissionDuration;

    [Header("現在のゲームの進行状態")]
    public GameState currentGameState;


    private IEnumerator Start() {

        // ゲームの状態を準備中にする
        currentGameState = GameState.Wait;


        // TODO ルート用の経路情報を設定


        // イベント生成機能の準備
        eventGenerator.SetUpEventGenerator(this, playerController);


        ////*　ここから TODO を実装　*////


        // 初期武器登録
        GameData.instance.AddWeaponData(DataBaseManager.instance.GetWeaponData(0));


        // TODO 武器取得イベント用の設定



        // 初期武器設定
        playerController.InitBulletData(GameData.instance.weaponDatasList[0]);  //　<=　引数を変更します。


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


        // RailMoveController の初期設定
        railMoveController.SetUpRailMoveController(this);

        // パスデータよりミッションの発生有無情報取得
        SetMissionTriggers();

        // 次に再生するレール移動の目的地と経路のパスを設定
        railMoveController.SetNextRailPathData(originRailPathData);

        // 経路の準備が完了するのを待つ
        yield return new WaitUntil(() => railMoveController.GetMoveSetting());

        // ゲームの状態をプレイ中に変更する
        currentGameState = GameState.Play_Move;
    }

    /// <summary>
    /// パスデータよりミッションの発生有無情報取得
    /// </summary>
    private void SetMissionTriggers() {

        // 配列の初期化
        isMissionTriggers = new bool[originRailPathData.GetIsMissionTriggers().Length];

        // ミッション発生有無の情報を登録
        isMissionTriggers = originRailPathData.GetIsMissionTriggers();
    }

    /// <summary>
    /// ミッションの発生有無の判定
    /// </summary>
    /// <param name="index"></param>
    public void CheckMissionTrigger(int index) {

        if (isMissionTriggers[index]) {

            // ミッション発生
            PreparateMission(originRailPathData.pathDataDetails[index].missionEventDetail);

            Debug.Log("ミッション発生");

        } else {
            // ミッションなし。次のパスへ移動を再開
            railMoveController.CountUp();
        }
    }

    /// <summary>
    /// ミッションの準備
    /// </summary>
    /// <param name="missionEventDetail"></param>
    private void PreparateMission(MissionEventDetail missionEventDetail) {

        // ミッションの時間設定
        currentMissionDuration = missionEventDetail.missionDuration;


        // TODO 武器取得イベントか判定


        // ミッション内の各イベントの生成(敵、ギミック、トラップ、アイテムなどを生成)
        eventGenerator.PrepareGenerateEnemies(missionEventDetail.enemyPrefabs, missionEventDetail.eventTrans);


        // ミッション開始
        StartCoroutine(StartMission(missionEventDetail.clearConditionsType));
    }

    /// <summary>
    /// ミッション開始
    /// </summary>
    /// <param name="clearConditionsType"></param>
    /// <returns></returns>
    private IEnumerator StartMission(ClearConditionsType clearConditionsType) {

        // ゲームの進行状態をミッション中に変更
        currentGameState = GameState.Play_Mission;

        // ミッションの監視
        yield return StartCoroutine(ObservateMission(clearConditionsType));

        // ミッション終了
        EndMission();
    }

    /// <summary>
    /// ミッションの監視
    /// 各イベントの状態を監視
    /// </summary>
    /// <param name="clearConditionsType"></param>
    /// <returns></returns>
    private IEnumerator ObservateMission(ClearConditionsType clearConditionsType) {

        // クリア条件を満たすまで監視(currentMissionDuration 変数には、敵の数か、残り時間が入る)
        while (currentMissionDuration > 0) {

            // クリア条件が時間経過の場合
            if (clearConditionsType == ClearConditionsType.TimeUp) {

                // カウントダウン
                currentMissionDuration--;
            }

            // TODO 武器取得イベントかつ、武器選択のいずれかのボタンを押したら


            yield return null;
        }

        Debug.Log("ミッション終了");
    }

    /// <summary>
    /// ミッション終了
    /// </summary>
    public void EndMission() {

        // TODO 武器の取得イベントの場合には武器を取得せずにポップアップを閉じる


        // 今回分の敵の情報をクリア
        ClearEnemiesList();

        // ゲームの進行状態を移動中に変更
        currentGameState = GameState.Play_Move;

        // カメラの移動再開
        railMoveController.CountUp();
    }

    /// <summary>
    /// 敵の List をクリア
    /// </summary>
    private void ClearEnemiesList() {
        if (enemiesList.Count > 0) {
            for (int i = 0; i < enemiesList.Count; i++) {
                Destroy(enemiesList[i]);
            }
        }

        enemiesList.Clear();
    }

    /// <summary>
    /// 敵の情報を List から削除し、ミッション内の敵の残数を減らす
    /// </summary>
    /// <param name="enemy"></param>
    public void RemoveEnemyList(EnemyController enemy) {

        currentMissionDuration--;

        enemiesList.Remove(enemy);
    }

    /// <summary>
    /// 敵の情報をリストに追加
    /// </summary>
    /// <param name="enemy"></param>
    public void AddEnemyList(EnemyController enemy) {
        enemiesList.Add(enemy);
    }
}

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

　プレイヤーの初期武器の登録について処理を追加しました。

　実際にゲームを実行し、GameData クラス内の List に武器の情報が追加されるかを確認します。
追加される武器の情報は WeaponDataSO スクリプタブル・オブジェクトの内容になっていれば制御成功です。

GameData ゲームオブジェクト　インスペクター画像

WeaponDataSO スクリプタブル・オブジェクトのデータを参照している

Console ビュー画像

　GameData の WeaponDataList 変数内にある武器は１種類だけですので、武器の切り替えボタンを押しても、切り替えは機能しませんが、切り替える武器がない場合には、それが正常な動作になります。

　それではこの手順の最後に、自分で武器を追加する処理を考えて実装し、
武器の切り替え機能が正常に動作するかを確認してみましょう。

＜応用＞武器を追加して、切り替え機能の確認を行う

　GameManager スクリプトを修正し、初期武器の他にも２種類の武器を追加し、
合計で３つの武器を List で管理できるようにしてください。

　その処理が完成したら、ゲームを実行して、複数の武器が GameData の List に追加されるか、確認します。

＜実装動画①　ゲーム実行時にデバッグ用に武器の情報が複数 List に追加される＞

動画ファイルへのリンク

GameData ゲームオブジェクト　インスペクター画像

List 内を展開した際

Console ビュー画像

　無事に List に武器が複数登録されたら、武器の切り替えボタンを押してください。
　ここでは確認するポイントが２つあります。

　最初に WeaponChanger ゲームオブジェクトのインスペクターを順番に確認してください。

　武器の切り替えボタンを押すたびに currentWeaponNo 変数の値が１つずつ加算されていき、
武器の最大値になったら 0 に戻っていれば制御成功です。

＜実装動画②　武器の切り替えボタンを押すたびに値が変わり、武器の最大数(今回は 3)になったら 0 に戻る＞

動画ファイルへのリンク

　次に PlayerController スクリプトのアタッチされているゲームオブジェクトのインスペクターを順番に確認してください。
武器を切り替えた際 List に、今まで利用していた武器の番号と残弾数が登録されれば制御成功です。

　すでに登録されている武器の場合には、残弾数のみ更新されて、同じ武器の番号の武器は重複登録されていないことを確認してください。

＜実装動画③ー１ PlayerController の使用している武器の情報が切り替えによって List に更新される＞

動画ファイルへのリンク

＜実装動画③ー２ PlayerController の使用している武器の情報が切り替えによって List に更新される＞

動画ファイルへのリンク

＜実装動画③ー３同じ武器の場合には、すでにある残弾数が更新される＞

動画ファイルへのリンク

　以上の部分をすべて確認してください。

　結果として、無事に３種類の武器が順番に切り替わり、最後の武器の切り替えを行ったら、最初に武器に切り替えが行われれば制御成功です。

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

　=>　次は　学習の振り返りー　です。

このページを編集するこのページを元に新規ページを作成

印刷する

コメント（0）

３Ｄレールガンシューティング　手順２０ - i-school 先頭へ

コメントをかく

名前	ユーザIDを使用しないで書き込む	ユーザーIDを使う	ログインする
画像コード	画像に記載されている文字を下のフォームに入力してください。
備考	「http://」を含む投稿は禁止されています。
本文
利用規約をご確認のうえご記入下さい

i-school