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

　今後エネミーの移動方法が増えることを想定して、エネミーの移動方法を別の手法に変更を行います。
これはリファクタリングになりますので、ゲーム上の挙動は変わらず、スクリプトの内容を改修する内容になります。

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

発展１１　－エネミーの移動用のスクリプタブル・オブジェクトの作成と運用－

２１．エネミーの移動用の MoveEventSO スクリプタブル・オブジェクトを作成する
２２．エネミーの移動方法に応じて MoveEventSO スクリプタブル・オブジェクトに用意されたメソッドを UnityAction に登録して移動を実行する

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

　・スクリプタブル・オブジェクトの新しい使い方
　・UnityAction(デリゲート)の使い方
　・DOAnchorPos メソッド

２１．エネミー用の移動用のスクリプタブル・オブジェクトを作成する

１．設計

　この手順では、エネミーの移動方法についてリファクタリングを行います。
新しい機能がありますので、書いてある内容が難しい、実装したいけど処理が読めない、という場合にはこの手順は飛ばしてください。
自分のスキルに合わせて学習を行っていただければ問題ありません。あとで振り返ってみてください。

　エネミー用のデータベースとして利用する目的で EnemyDataSO スクリプトを作成し、
EnemyDataSO スクリプタブル・オブジェクトを作成して、設定を行ってきました。

　スクリプタブル・オブジェクトにはこのようにデータベースとして利用できる部分の他に、
特定のゲームオブジェクトに依存しない(紐づかない)、という特性を生かして、
関連するメソッドを登録してメソッドを扱うデータベースとして利用する方法があります。

　現在エネミーの移動については EnemyController スクリプトに記述をしてきました。
今の所２つの移動方法がメソッドとして作成されていますが、これには２つの大きな問題点があります。

　まず１つが、移動方法が１つ増えるたびに、EnemyController スクリプト自体が肥大化してしまうということ、
もう１つは、エネミーが利用する移動方法は１つのはずなのに、他に利用しない移動の情報も管理しているということ、この２つです。

　例えばエネミーの種類を増やして移動方法を５種類に増やす、と仮定して考えてみてください。
５つの移動用のメソッドを EnemyController スクリプトに追加することになりますが、
実際に５つのメソッドをすべて利用するエネミーは存在しません。いずれか１つの移動用のメソッドがあれば充分なはずです。

　そしてメソッドが増えるということは、EnemyController スクリプトに記述される処理が必然的に増えていきます。
移動処理以外のメソッドはエネミーの管理や運行に合わせて必要なメソッドや変数で構成されていますので、
本来は必要な情報のみで１つのスクリプトが構成されていることが理想的です。

　この部分の問題点を解決する方法の１つとして、今回はスクリプタブル・オブジェクトを利用します。
もちろん、他にも方法はありますので、いくつかある中の１つ、として捉えておくことが大切です。視野は広く持っておきましょう。

　スクリプタブル・オブジェクト内にエネミーの移動用のメソッドを用意し、エネミーの移動方法に合わせて適切なメソッドを準備します。
EnemyController スクリプト側では、スクリプタブル・オブジェクトより、エネミーの移動方法に合わせたメソッドを１つ、取得します。
そしてそれを実行する、という流れになります。

　この処理を実装するためには、UnityAction という Unity が用意している処理を利用します。
UnityAction はデリゲートと呼ばれる C#　プログラムの機能を利用している処理です。
デリゲートとはメソッドを参照する型のことを言います。
　
　実際に利用する場合には、メソッドを登録しておける変数、というニュアンスで考えてもらっても問題ありません。
変数の値としてメソッドを登録しておくことで、その変数を実行する形で、登録されているメソッドを実行することができる処理ととらえるといいです。

　実際に作成しながら処理を見ていきます。

２．MoveEventSO スクリプトを作成する

　スクリプタブル・オブジェクトを作成するために必要な情報や記述の方法は覚えていますか？
発展２に詳細な手順がありますので、復習しながら処理を記述していきましょう。

　今回はデータベースとして利用する訳ではありませんので、List や入れ子クラスなどの宣言は不要です。
代わりに、今まで EnemyController スクリプトに記述されていた移動方法によって分岐を行うメソッドと、移動の処理を行うメソッドを記述方法を変えて用意します。

　変数では const キーワードを利用しています。このキーワードを宣言した変数の値は定数として扱われるようになり、ゲーム内での値の変更が出来なくなります。
そのため、ゲーム内で利用する際に定値(ゲーム開始から終わりまで変わらない値)を扱う場合には宣言しておくことで、値の変更を防ぐことが出来ます。

参考サイト

Microsoft const (C# リファレンス)
https://docs.microsoft.com/ja-jp/dotnet/csharp/lan...

MoveEventSO.cs

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

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using DG.Tweening;
using UnityEngine.Events;                  //  ☆　<=　UnityAction を利用する際に宣言を追加します

[CreateAssetMenu(fileName = "MoveEventSO", menuName = "Create MoveEventSO")]
public class MoveEventSO : ScriptableObject
{
    private const float moveLimit = -3000.0f;     // 拠点の位置 

    /// <summary>
    /// MoveType に応じた移動方法を決定してイベントとして登録
    /// </summary>
    /// <param name="moveType"></param>
    /// <returns></returns>
    public UnityAction<Transform, float> GetMoveEvent(MoveType moveType) {

　　　　// moveType で分岐
        switch (moveType) {
             
            // Straight の場合
            case MoveType.Straight:
                return MoveStraight;

　　　　　　// Meandering の場合
            case MoveType.Meandering:
                return MoveMeandering;

　　　　　　// Boss_Horizontal の場合
            case MoveType.Boss_Horizontal:
                return MoveBossHorizontal;

            // 上記以外の場合
            default:
                return Stop;
        }
    }

    /// <summary>
    /// 直進移動
    /// </summary>
    /// <param name="tran"></param>
    /// <param name="duration"></param>
    private void MoveStraight(Transform tran, float duration) {
        Debug.Log("直進");

        tran.DOLocalMoveY(moveLimit, duration);
    }

    /// <summary>
    /// 蛇行移動
    /// </summary>
    /// <param name="tran"></param>
    /// <param name="duration"></param>
    private void MoveMeandering(Transform tran, float duration) {
        Debug.Log("蛇行");

        // 左右方向の移動をループ処理することで行ったり来たりさせる。左右の移動幅はランダム、移動間隔は等速
        tran.DOLocalMoveX(tran.position.x + Random.Range(200.0f, 400.0f), 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);

        tran.DOLocalMoveY(moveLimit, duration);
    }

    /// <summary>
    /// ボス・水平移動
    /// </summary>
    /// <param name="tran"></param>
    /// <param name="duration"></param>
    public void MoveBossHorizontal(Transform tran, float duration) {
        tran.localPosition = new Vector3(0, tran.localPosition.y, tran.localPosition.z);

        tran.DOLocalMoveY(-500, 3.0f).OnComplete(() => {

            Sequence sequence = DOTween.Sequence();
            sequence.Append(tran.DOLocalMoveX(tran.localPosition.x + 550, 2.5f).SetEase(Ease.Linear));
            sequence.Append(tran.DOLocalMoveX(tran.localPosition.x - 550, 5.0f).SetEase(Ease.Linear));
            sequence.Append(tran.DOLocalMoveX(tran.localPosition.x, 2.5f).SetEase(Ease.Linear));
            sequence.AppendInterval(1.0f).SetLoops(-1, LoopType.Restart);
        });
    }

    /// <summary>
    /// 移動停止
    /// </summary>
    /// <param name="tran"></param>
    /// <param name="duration"></param>
    public void Stop(Transform tran, float duration) {

        Debug.Log("停止");
    }
}

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

３．MoveEventSO スクリプタブル・オブジェクトを作成する

　Unity の左上のメニューより、Assets => Create => Create MoveEventSO を選択します。
新しく MoveEventSO というファイルが作成されます。名前はそのままで構いません。

　MoveEventSO スクリプタブル・オブジェクトを Datas フォルダへ移動してください。
スクリプタブル・オブジェクトを作成したら、Datas フォルダ内で管理するようにします。

　データベースとして数値を管理するために利用する訳ではありませんので、設定は不要です。
MoveEventSO スクリプタブル・オブジェクトのインスペクターを見ても登録できるような情報はありません。

４．EnemyGenerator スクリプトを修正して、MoveEventSO スクリプタブル・オブジェクトを利用できる状態にする

　スクリプタブル・オブジェクトはいずれかのスクリプトに変数を用意することで利用可能になります。
エネミーの移動方法を設定し、移動処理を実行しているアセットになりますので、今回も EnemyGenerator スクリプトに
public 修飾子の MoveEventSO 型の変数を用意してインスペクターよりアサインできるようにしましょう。

　なお、型は MoveEventSO 型での宣言になりますが、アサイン可能なのは、MoveEventSO スクリプタブル・オブジェクトです。
MoveEventSO スクリプトは直接アサインできません。何故ならば、アサイン出来る情報は、ゲームオブジェクトか、特定のアセットに限られるためです。
(今までのアサインを思い出してください。ヒエラルキーにあるゲームオブジェクト、あるいはプレファブのみをアサインしているはずです)
混同しやすいので間違えないようにしてください。

　また無事にエネミーの種類ごとに List が作成されることが確認できましたので、
normalEnemyDatas 変数と bossEnemyDatas 変数については pulbic 修飾子ではなく、private 修飾子に変更しておいてください。

EnemyGenerator.cs

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

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

public class EnemyGenerator : MonoBehaviour
{
    [SerializeField, Header("エネミーのプレファブ")]
    private GameObject enemyObjPrefab;

    [SerializeField, Header("エネミー生成までの準備時間")]
    public float preparateTime;

    private int generateCount;     // 生成したエネミーの数をカウントするための変数

    private float timer;           // 準備時間の計測用の変数

    private GameManager gameManager;

    [Header("エネミーの最大生成数")]
    public int maxGenerateCount;

    [Header("エネミーの生成完了管理用")]
    public bool isGenerateEnd;

    [Header("ボス討伐管理用")]
    public bool isBossDestroyed;

    [Header("エネミーのスクリプタブル・オブジェクト")]
    public EnemyDataSO enemyDataSO;


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


    // Normal タイプのエネミーのデータだけ代入されている List
    private List<EnemyDataSO.EnemyData> normalEnemyDatas = new List<EnemyDataSO.EnemyData>();　　　//　<=　☆　List が正常に動作していることがわかっているので修飾子を private にしてください。

    // Boss タイプのエネミーのデータだけ代入されている List
    private List<EnemyDataSO.EnemyData> bossEnemyDatas = new List<EnemyDataSO.EnemyData>();      　//　<=　☆　List が正常に動作していることがわかっているので修飾子を private にしてください。


    [Header("エネミー移動用のスクリプタブル・オブジェクト")]
    public MoveEventSO moveEventSO;


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


    /// <summary>
    /// EnemyGenerator の設定
    /// </summary>
    /// <param name="gameManager"></param>
    public void SetUpEnemyGenerator(GameManager gameManager) {

        // EnemyGenerator スクリプトの gameManager 変数に、引数で届いた GameManager スクリプトの情報を代入
        this.gameManager = gameManager;

        // 引数で指定したエネミーのタイプのリストを作成
        normalEnemyDatas = GetEnemyTypeList(EnemyType.Normal);

        bossEnemyDatas = GetEnemyTypeList(EnemyType.Boss);

        // GameData よりエネミーの最大生成数を取得
        maxGenerateCount = GameData.instance.GetMaxGenerateCount();
    }

    /// <summary>
    /// エネミー生成の準備
    /// </summary>
    private void PreparateGenerateEnemy() {

        // 時間の計測
        timer += Time.deltaTime;

        // 準備時間を超えたら
        if (timer >= preparateTime) {

            // 次回の時間の計測を行うためにリセット
            timer = 0;

            // エネミーの生成
            GenerateEnemy();

            // 生成したエネミーの数をカウントアップ
            generateCount++;
            
            Debug.Log("生成したエネミーの数 : " + generateCount);
            
　　　　　　// 今までに生成したエネミーの数が、エネミーの最大生成数の値と同じか超えたら
　　　　　　if (generateCount >= maxGenerateCount) {

　　　　　　　　// 生成完了の状態にする = Update メソッドでこの値を利用して、生成完了状態になったら生成の準備処理が実行されないように制御する
                isGenerateEnd = true;

                Debug.Log("生成完了");

                // ボスの生成
                StartCoroutine(GenerateBoss());
            }
        }
    }

    /// <summary>
    /// エネミーの生成
    /// </summary>
    private void GenerateEnemy(EnemyType enemyType = EnemyType.Normal) {

　　　　// ランダムな値を代入するための変数を宣言
　　　　int randomEnemyNo;

　　　　// EnemyData を代入するための変数を宣言
        EnemyDataSO.EnemyData enemyData = null;

        // EnemyType に合わせて生成するエネミーの種類を決定し、そのエネミーの種類ごとのリストからランダムな EnemyData を取得
        switch (enemyType) {
            case EnemyType.Normal:
                randomEnemyNo = Random.Range(0, normalEnemyDatas.Count);
                enemyData = normalEnemyDatas[randomEnemyNo];
                break;
            case EnemyType.Boss:
                randomEnemyNo = Random.Range(0, bossEnemyDatas.Count);
                enemyData = bossEnemyDatas[randomEnemyNo];
                break;
        }

        // プレファブからエネミーのクローンを生成する。生成位置は EnemyGenerator の位置
        GameObject enemySetObj = Instantiate(enemySetPrefab, transform, false);    //  <=  左辺に GameObject 型の変数を用意して、インスタンスされたエネミーの情報を戻り値で受け取る

　　　　// エネミーのゲームオブジェクト(enemySetObj 変数の値)にアタッチされている EnemyController スクリプトの情報を取得して変数に代入
        EnemyController enemyController = enemySetObj.GetComponent<EnemyController>();

        // EnemyController スクリプトの SetUpEnemy メソッドを実行する　=>　Start メソッドの代わりになる処理
        enemyController.SetUpEnemy(enemyData);

        // Boss 以外でも追加設定を行う
        enemyController.AdditionalSetUpEnemy(this);
    }

    void Update() {

        // 生成完了の状態になったら生成処理を行わないようにする
        if (isGenerateEnd) {
            return;
        }

　　　　// ゲーム終了の状態ではないなら
        if (!gameManager.isGameUp) {

            // エネミー生成の準備
            PreparateGenerateEnemy();               
        }
    }

    /// <summary>
    /// ボスの生成
    /// </summary>
    private IEnumerator GenerateBoss() {

        // TODO ボス出現の警告演出
        
        yield return new WaitForSeconds(1.0f);

        // ボス生成
        GenerateEnemy(EnemyType.Boss);
    }

    /// <summary>
    /// ボス討伐状態の切り替え
    /// </summary>
    /// <param name="isSwitch"></param>
    public void SwitchBossDestroyed(bool isSwitch) {
        // ボスの討伐状態を切り替え
        isBossDestroyed = isSwitch;

        Debug.Log("ボス討伐");

        // ボス討伐に合わせて、ゲーム終了の状態に切り替える
        gameManager.SwitchGameUp(isBossDestroyed);

        // ゲームクリアの準備
        gameManager.PreparateGameClear();
    }

    /// <summary>
    /// 引数で指定されたエネミーの種類のListを作成し、作成した値を戻す
    /// </summary>
    /// <param name="enemyType"></param>
    /// <returns></returns>
    private List<EnemyDataSO.EnemyData> GetEnemyTypeList(EnemyType enemyType) {

        List<EnemyDataSO.EnemyData> enemyDatas = new List<EnemyDataSO.EnemyData>();

        // 引数のタイプのエネミーのデータだけを抽出して enemyDatas リストに EnemyData を追加して、List を作成していく
        for (int i = 0; i < enemyDataSO.enemyDataList.Count; i++) {
            if (enemyDataSO.enemyDataList[i].enemyType == enemyType) {
                enemyDatas.Add(enemyDataSO.enemyDataList[i]);
            }
        }

        // 抽出処理の結果を戻す
        return enemyDatas;
    }

    /// <summary>
    /// TotalExp の表示更新準備
    /// </summary>
    /// <param name="exp"></param>
    public void PreparateDisplayTotalExp(int exp) {

        // GameManager スクリプトから UIManager スクリプトの UpdateDisplayTotalExp メソッドを実行する
        gameManager.uiManager.UpdateDisplayTotalExp(exp);

        // TODO 引数の exp 変数は後々利用する

    }
}

　スクリプトを修正したらセーブします。

　EnemyGenerator ゲームオブジェクトのインスペクターを確認して、private 修飾子に変更した変数の表示がなくなり、
新しく public 修飾子で宣言した変数が表示されているかを確認してください。

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

５．EnemyGenerator ゲームオブジェクトの設定を行う

　MoveEventSO スクリプタブル・オブジェクト用の変数を宣言していますので、Datas フォルダにある
MoveEventSO スクリプタブル・オブジェクトをドラッグアンドドロップしてアサインして登録してください。

　MoveEventSO スクリプトは登録できません。スクリプタブル・オブジェクトの方を選択してください。

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

　以上で設定は完了です。これで MoveEventSO スクリプタブル・オブジェクトを利用することができるようになりました。

２２．エネミーの移動方法に応じて MoveEventSO スクリプタブル・オブジェクトに用意されたメソッドを UnityAction に登録して移動を実行する

１．設計

　エネミーの移動用のメソッドをすべて MoveEventSO スクリプタブル・オブジェクトにまとめて記述しました。
こちらをエネミーのデータを参照したときのように、エネミーの MoveType の種類に応じて、対象となる移動用メソッドを取得して利用出来るようにします。
　
　ここでは先ほど説明した、UnityAction という機能を利用します。この型を変数を用意することで、移動用のメソッドを変数に代入することが出来ます。
そのため、EnemyController スクリプトにある移動用のメソッドを一切使わずに、移動の処理を実行出来るようになります。

　手順としては、エネミーにある EnemData クラス内にある MoveType を利用して、どの移動方法にするが分岐する部分は同じですが、
ここでメソッドを実行するのではなく、移動用のメソッドを UnityAction 型の変数に登録するようにします。

　その後、EnemyController スクリプトでは登録されたメソッドを実行します。
このようにすることで、EnemyController スクリプトには、移動用のメソッドを書くことなく、エネミーの移動方法に応じた移動用のメソッドを処理出来るようになります。

＜ロジックの流れ＞

　１．EnemyController スクリプトに UnityActon 型の変数を用意する
　２．EnemyController スクリプトから、MoveEventSO スクリプタブル・オブジェクトの GetMoveEvent メソッドを実行する。引数として、エネミーの移動方法(MoveType)を渡す
　　　　この処理を実行するに際し、GetMoveEvent メソッドには戻り値として UnityActon 型で移動用のメソッドを取得して戻してくれるので、受け取って登録するための UnityActon 型の変数を左辺に用意しておく
　３．EnemyController スクリプトにて、UnityActon 型の変数に登録された移動用のメソッドを実行する。エネミーの移動方法に応じた移動が処理される

　以上のような流れになります。

参考サイト

Unity公式スクリプトリファレンス
UnityAction
https://docs.unity3d.com/ja/current/ScriptReferenc...

Kan のメモ帳様
デリゲート(Delegate)やイベント(Event)とは【C#】
https://kan-kikuchi.hatenablog.com/entry/Delegate

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

　UnityActon 型を宣言するためには using に宣言の追加が必要になります。

　UnityActon 型には <T> というジェネリック型(任意の型)での型パラメータの指定が出来ます。最大で４つまで指定できます。
今回は UnityAction<Transform, float> 型という型になり、処理を実行する際に型パラメータで指定した型の情報が必要になります。

EnemyController.cs

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using DG.Tweening;
using UnityEngine.Events;                  //  ☆　<=　UnityAction を利用する際に宣言を追加します

[RequireComponent(typeof(CapsuleCollider2D))]
public class EnemyController : MonoBehaviour

    [Header("エネミーのデータ情報")]
    public EnemyDataSO.EnemyData enemyData; // SetUpEnemy メソッドにて引数として受けとったエネミーのデータを代入する。これにより、振る舞いが変わる

    [SerializeField]
    private Image imgEnemy;                 // エネミーの画像の設定用　　　 

    [SerializeField]
    private Slider slider;

    [SerializeField]
    private GameObject bulletEffectPrefab;      // ヒット演出用のエフェクトのプレファブをインスペクターよりアサインして登録する

    private int maxHp;                          // HPの最大値を代入する変数
 
    private int hp;                             // エネミーのHP。EnemyData でHpの値が取得できるので、それを代入する。public にしてインスペクターで設定する必要なし

    private EnemyGenerator enemyGenerator;      // EnemyGenerator を利用するための変数


////*  変数を追加する  *////


    private UnityAction<Transform, float> moveEvent;    // UnityAction<Transform, float> 型の moveEvent 変数と読む。ここにエネミーの移動方法に応じた移動用のメソッドを登録する


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


    /// <summary>
    /// エネミーの設定
    /// </summary>
　　public void SetUpEnemy(EnemyDataSO.EnemyData enemyData) {

　　　　// 引数で届いた EnemyData を代入する
        this.enemyData = enemyData;

        // ボスではない場合
        if (this.enemyData.enemyType != EnemyType.Boss) {

            // エネミーの X 軸(左右)の位置を、ゲーム画面に収まる範囲でランダムな位置に変更
            transform.localPosition = new Vector3(transform.localPosition.x + Random.Range(-650, 650), transform.localPosition.y, 0);
        } else {
          
            // ボスの位置を徐々に下方向に変更
            transform.DOLocalMoveY(transform.localPosition.y - 500, 3.0f);

            // ボスの場合、サイズを大きくする
            transform.localScale = Vector3.one * 2.0f;

            // Hpゲージの位置を高い位置にする
            slider.transform.localPosition = new Vector3(0, 150, 0);
        }
    
        // 画像を EnemyData の画像にする　=>　ここでエネミーごとの画像に変更する
        imgEnemy.sprite = this.enemyData.enemySprite;

        // EnemyData より Hp の値を最大値として代入
        maxHp = this.enemyData.hp;
        
        // hp を設定
        hp = maxHp;

　　　　// Hpゲージの表示更新
　　　　DisplayHpGauge();


////*  処理を削除する  *////


        // 移動タイプに応じた移動方法を選択して実行
        //SetMoveByMoveType();              //  <=  ☆　不要になりましたので、コメントアウトするか削除してください


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


    }

    // 侵入判定
    private void OnTriggerEnter2D(Collider2D col) {

　　　　// バレットが接触したら
        if (col.gameObject.tag == "Bullet") {
　
            // バレットの破壊処理を呼び出す(メソッド名を修正すれば、一緒に修正される)
　　　　　　DestroyBullet(col);

            // 侵入してきたコライダーのゲームオブジェクトに Bullet スクリプトがアタッチされていたら取得して bullet 変数に代入して、if 文の中の処理を行う
            if (col.gameObject.TryGetComponent(out Bullet bullet)) {
            
                // HPの更新処理とエネミーの破壊確認の処理を呼び出す
                UpdateHp(bullet);　

                // バレットのヒット演出用エフェクトの生成
                GenerateBulletEffect(col.gameObject.transform);
            }
        }
    }

    /// <summary>
    /// バレットの破壊処理
    /// </summary>
    private void DestroyBullet(Collider2D col)
    {
        // バレットを破壊する
        Destroy(col.gameObject);
    }

    /// <summary>
    /// Hpの更新処理とエネミーの破壊確認処理
    /// </summary>
    private void UpdateHp(Bullet bullet)
    {
        // hpの減算処理
        hp -= bullet.bulletPower;

　　    // Hp の値の上限・下限を確認して範囲内に制限
　　　　hp = Mathf.Clamp(hp, 0, maxHp);

        // HPゲージの表示更新
        DisplayHpGauge();

        if (hp <= 0) {
            hp = 0;

            // ボスの場合
            if (enemyData.enemyType == EnemyType.Boss) {

                // ボス討伐済みの状態にする
                enemyGenerator.SwitchBossDestroyed(true);
            }

            // Exp を TotalExp に加算
            GameData.instance.UpdateTotalExp(enemyData.exp);

            // 最新の TotapExp を利用して表示更新
            enemyGenerator.PreparateDisplayTotalExp(enemyData.exp);

            // このゲームオブジェクトを破壊する
            Destroy(gameObject);
        } else {

            Debug.Log("残り Hp : " + hp);
        }
    }

    /// <summary>
    /// HPゲージの表示更新
    /// </summary>
    private void DisplayHpGauge() {

　　　　// HPゲージを現在値に合わせて制御
        slider.DOValue((float)hp / maxHp, 0.25f);
    }

    /// <summary>
    /// 被バレット時のヒット演出用のエフェクト生成
    /// </summary>
　　/// <param name="bulletTran"></param>
    private void GenerateBulletEffect(Transform bulletTran) {

　　　　// ヒット演出用のエフェクトを、バレットのぶつかった位置で生成
        GameObject effect = Instantiate(bulletEffectPrefab, bulletTran, false);

        // エフェクトをエネミーの子オブジェクトにする
        effect.transform.SetParent(transform);

        Destroy(effect, 3.0f);
    }

    /// <summary>
    /// エネミーの追加設定
    /// </summary>
    /// <param name="enemyGenerator"></param>
    public void AdditionalSetUpEnemy(EnemyGenerator enemyGenerator) {

        // 引数で届いた情報を変数に代入してスクリプト内で利用できる状態にする
        this.enemyGenerator = enemyGenerator;


////*  ここから追加  *////


        // MoveEventSO スクリプタブル・オブジェクトの GetMoveEvent メソッドを実行し、戻り値で移動用のメソッドを受け取る。ここで移動方法を決定
        moveEvent = this.enemyGenerator.moveEventSO.GetMoveEvent(enemyData.moveType);

        // Invoke メソッドを実行すると、moveEvent 変数に登録されたメソッド(今回は移動用のメソッド)を実行する。UnityActon <Transform, float>型なので、実行にあたって、指定された型の情報を指定する
        moveEvent.Invoke(transform, enemyData.moveDuration);


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


        Debug.Log("追加設定完了");
    }


////*  以下の４つメソッドを削除  *////


    /// <summary>
    /// 移動タイプに応じた移動方法を選択して実行
    /// </summary>
    private void SetMoveByMoveType() {
        
        // moveType で分岐
        switch (enemyData.moveType) {
             
            // Straight の場合
            case MoveType.Straight:
                MoveStraight();
                break;

            // Meandering の場合
            case MoveType.Meandering:
                MoveMeandering();
                break;

            // Boss_Horizontal の場合
            case MoveType.Boss_Horizontal:
                MoveBossHorizontal();
                break;
        }
    }

    /// <summary>
    /// 直進移動
    /// </summary>
    private void MoveStraight() {
        Debug.Log("直進");

        transform.DOLocalMoveY(-3000, enemyData.moveDuration);
    }

　　/// <summary>
    /// 蛇行移動
    /// </summary>
    private void MoveMeandering() {
        Debug.Log("蛇行");

        // 左右方向の移動をループ処理することで行ったり来たりさせる。左右の移動幅はランダム、移動間隔は等速
        transform.DOLocalMoveX(transform.position.x + Random.Range(200.0f, 400.0f), 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);

        transform.DOLocalMoveY(-3000, enemyData.moveDuration);
    }

    /// <summary>
    /// ボス・水平移動
    /// </summary>
    public void MoveBossHorizontal() {

　　　　tran.localPosition = new Vector3(0, tran.localPosition.y, tran.localPosition.z);

        tran.DOLocalMoveY(-500, 3.0f).OnComplete(() => {
            Sequence sequence = DOTween.Sequence();
            sequence.Append(transform.DOLocalMoveX(transform.localPosition.x + 550, 2.5f).SetEase(Ease.Linear));
            sequence.Append(transform.DOLocalMoveX(transform.localPosition.x - 550, 5.0f).SetEase(Ease.Linear)); 
            sequence.Append(transform.DOLocalMoveX(transform.localPosition.x, 2.5f).SetEase(Ease.Linear));
            sequence.AppendInterval(1.0f).SetLoops(-1, LoopType.Restart);　　　　　　　　　　　　　　　　　
        });
    }


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


}

　スクリプトを修正したらセーブします。

３．UnityAction に関する一連の処理を読み解く

　処理を順番に読み解いてみましょう。

＜EnemyController.cs＞

  // 変数を用意する
  private UnityAction<Transform, float> moveEvent;

　ここに移動用のメソッドを取得して代入します。

  // MoveEventSO スクリプタブル・オブジェクトの GetMoveEvent メソッドを実行し、戻り値で移動用のメソッドを受け取る。ここで移動方法を決定
  moveEvent = this.enemyGenerator.moveEventSO.GetMoveEvent(enemyData.moveType);

　↓　右辺の処理は、以下の通り

＜MoveEventSO スクリプタブル・オブジェクト　GetMoveEvent メソッド。moveType で分岐し、UnityActon<Transform, float> 型で値が戻る＞

public UnityAction<Transform, float> GetMoveEvent(MoveType moveType) {
　　switch (moveType) {
    　　case MoveType.Straight:
        　　return MoveStraight;
        case MoveType.Meandering:
            return MoveMeandering;
        case MoveType.Boss_Horizontal:
            return MoveBossHorizontal;
        default:
            return Stop;
    }
}

　　↓　右辺の処理が終了すると、エネミーの moveType に応じた移動用のメソッドが１つだけ戻り値として取得できる

＜EnemyController.cs＞

  // MoveEventSO スクリプタブル・オブジェクトの GetMoveEvent メソッドを実行し、戻り値で移動用のメソッドを受け取る。ここで移動方法を決定
　// どちらも UnityAction<Transform, float> であるので、代入が成立する
  moveEvent = UnityAction<Transform, float> 型のメソッドが１つ戻ってくる

　　↓　moveEvent 変数には移動用のメソッドが登録されているので、Invoke メソッドを実行して処理をする

  // Invoke メソッドを実行すると、moveEvent 変数に登録されたメソッド(今回は移動用のメソッド)を実行する。UnityActon <Transform, float>型なので、実行にあたって、指定された型の情報を指定する
  moveEvent.Invoke(transform, enemyData.moveDuration);

　変数の中にメソッドが登録できる、というのは不思議に思えるかもしれませんが、以前からこれに近い処理は実装しています。
Button クラスの AddListener メソッドがこれに当たります。引数に、ボタンを押した際に実行したいメソッドを登録していたはずです。

　今回の UnityAction の機能でポイントとなるのは、移動用のメソッドに対して必要な引数の情報を型パラメータという形で指定していることです。
UnityAction<Transform, float> 型とは、すべての移動用のメソッドで使用する引数の型を指定していることが分かります。

　確認してみましょう。

＜MoveEventSO スクリプタブル・オブジェクト＞

    public void MoveStraight(Transform tran, float duration) {
        //Debug.Log(tran);
        Debug.Log("直進");

        tran.DOLocalMoveY(moveLimit, duration);
    }

　デリゲートには複数のメソッドを登録して順番に実行するという機能もありますし、実行するタイミングを自分で設定できるので、活用できると便利な機能になります。
少しずつ覚えていきましょう。　

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

　リファクタリングをおこなったので、ゲーム上の機能は何も変わりません。
そのため、この処理を実行した際に、今までと同じように動くことが大切です。

　もしも以前のように上手く移動が機能しないのであれば、それはリファクタリングの際に記述誤りがあります。
処理を１つずつ順番に追っていって、どの部分で正常に動いていないかを特定し、エラー箇所を探して修正してください。

５．＜蛇行処理の補足＞

　蛇行移動の処理について補足説明します。

    private void MoveMeandering(UnityEngine.Transform tran, float duration)
    {
        Debug.Log("蛇行");

        tran.DOLocalMoveX(tran.position.x + 150, 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);  //<= ここ。DOLocalMoveX(tran.position.x + 150, 1f)で動く距離は固定している
        tran.DOLocalMoveY(moveLimit, duration);
    }

　ソースコードでは左右の移動幅は固定しているはずですが、ゲームを実行すると、同じ敵であっても異なる移動幅になっています。

＜検証動画＞

動画ファイルへのリンク

　この処理は動いてはいますが、実は、DOTween の第1引数に対して、正しくない指定をわざとしている処理になります。
　
　DOTween で利用しているメソッドは、DOLocalMoveX メソッドです。
そのため、本来であれば第1引数には、移動させたいゲームオブジェクトの LocalPosition を指定する必要があります。
これは利用するDOTween のメソッドにより、引数の指定が決まるためです。

　ポイントは利用しているメソッドと引数の指定です。
DOMove メソッドであれば第1引数はワールド座標(通常の Position) を指定します。
ただし、DOLocalMove メソッドのように、Local の単語がメソッドにあれば、第1引数にはローカル座標(localPosition) を指定することで、本来の正しい処理になります。
これは他の DOTween の場合も同様です。名前をヒントに、利用する引数が変わります。

　ですが今回は、tran.position の形で、Local ではなく、ワールド座標での Position を指定しています。

tran.DOLocalMoveX(tran.position.x + 150, 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);

　そのため、計算がうまくいかず、移動の幅がその都度、ちぐはぐになっています。

　ただし、移動自体はするのと、規則性のなさが敵の移動っぽくていいと感じたので
今回はこれを、敵のランダム性という部分で利用しようとして、そのままわざと正しくない指定をしています。

　以上のことから、プログラム内で定数で移動幅をしているのに、移動幅が固定ではなくなぜ変わるのか？　というと
「引数の指定先が正しくないため、毎回、不安定な挙動になっている」ということになります。

　下記のように DOLocalMoveX メソッドの第1引数を正しい指定先に修正することで、毎回、同じ幅だけを移動する処理になります。

tran.DOLocalMoveX(tran.localPosition.x + 150, 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);

６．＜DOAnchorPos メソッド＞

　基本的に Canvas 内でのオブジェクトの移動は、常に Canvas か、あるいは他のオブジェクトの子オブジェクトになっているものを動かす可能性が高いので、
親からみた座標で相対的に移動ができる Local を利用するのが正しいですし、そうすることですべて同じ挙動になります。

　また、Canvas のオブジェクトは Anchor の位置によってオブジェクトの位置が設定されます。
そのため、アンカーが中央値(Middle、Center) でない場合、DOLocalMove で移動させると予期しない方向へ移動することがあります。

　これを回避するため、DOTween には DOAnchorPos という、UI 用の移動のメソッドが用意されています。
こちらを利用するもの１つの方法です。こちらも DOMove と同じで、3軸まとめて動かすメソッドと、各軸を指定して動かすメソッドがそれぞれあります。

　その場合、メソッドの命令先は Transform ではなくて、RectTransform に対して実行命令を出す形になります。
その代わりに、DOAnchorPos であれば、Anchor の位置に関係なく、LocalPosition で指定した位置に正しく移動できます。

　下記のように利用できます。試しに書き換えてみてください。

private void MoveMeandering(UnityEngine.Transform tran, float duration)
{
    Debug.Log("蛇行");

    // DOAnchorPosX、DOAnchorPosY の場合
    RectTransform rectTran = tran.GetComponent<RectTransform>();
    rectTran.DOAnchorPosX(tran.localPosition.x + 150, 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);
    rectTran.DOAnchorPosY(moveLimit, duration);
    
    // DOLocalMoveX の場合
    //tran.DOLocalMoveX(tran.localPosition.x + 150, 1f).SetLoops(-1, LoopType.Yoyo).SetEase(Ease.Linear);
    //tran.DOLocalMoveY(moveLimit, duration);
}

＜修正後の動画　ー同じ移動幅に固定化されるー＞

動画ファイルへのリンク

参考サイト

原カバンは鞄のお店ではありません。様
【Unity】DOTweenを使ったuGUIアニメーション

Zenn オオバ@ohbashunsuke 様
uGUI - RectTransformのトゥイーン｜【Unity】DOTweenの教科書～スクリプトでアニメーションを操るバイブル～

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

　次は　発展１２　エネミー用のバレットの作成と自動生成処理の実装－　です。