Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
3
Help us understand the problem. What is going on with this article?
@yKimisaki

Unityで寿命はあるけど広くアクセスさせたい変数の置き場を考える

More than 1 year has passed since last update.

UE4にはGameModeやGameInstanceという便利なクラスがあります。

Unityにはない概念かなと思うので、すごく簡単に説明すると
・GameInstance:ゲーム全体が寿命のインスタンス
・GameMode:シーン寿命のインスタンス
で、各々がGetGameInstanceやGetGameModeなどの関数で簡単にアクセスできるものです。
厳密にはネットワーク挟んだりするとサーバ側ではインスタンスがサーバ上のみになったりするので厳密にはこれではないのですが、今回の目的とはちょっとそれてしまうので割愛します。
良い名前が思いつかなかったのでUE4さんから借りた程度に思ってください。

public staticなものをあちこちからアクセスしたいって需要は普通にあって、でも初期化と破棄のタイミングを間違えてバグらせてしまうというのは大いにあるとは思うのですが、シーン読み込み時に初期化、シーン破棄時に破棄され、なおかつAdditiveなシーンからGetGameModeをした場合でもCurrentSceneのGameModeが取れたらいいのではないかと思い、軽く作ってみました。

簡単なテストで動いてはいるのですが、実際バグマミレだと思うので、私が実環境で使い始めるまではこんな感じで。

ちなみに2019.3の練習で作ったものなので、SerializeReference使っています。
ので2019.2以前では使えません。あしからず。

やりたいこと

Player.cs
using Tonari.Unity;
using UnityEngine;

namespace Assets.Scripts
{
    public class Player : MonoBehaviour
    {
        public void Start()
        {
            // このgameObjectがいるシーンのGameInstanceをもらう
            MyGameInstance gameInstance = gameObject.GetGameInstance<MyGameInstance>();
            // GameInstanceが持ってるアイテムマスタから装備情報をもらう
            var equipment = gameInstance.GetItemMaster(equipments[0].ItemId);

            // このgameObjectがいるシーンのGameModeをもらう
            MyBattleGameMode gameMode = gameObject.GetGameMode<MyBattleGameMode>();
            // 敵グループ管理のモデルに、自分を狙うようにお願いする
            // 敵グループ管理のモデルはバトル用ゲームモードが持っている
            gameMode.GetEnemyGroupModel().SetTargetPlayer(this);
        }
    }
}

使い方

GameInstanceのつくり方

SampleGameInstance.cs
using System;
using System.Collections.Generic;
using UnityEngine;

namespace Assets.Scripts
{
    /* SerializeReferenceのためにSerializableつけてください */
    [Serializable]
    public class SampleGameInstance : Tonari.Unity.GameInstance
    {
        [SerializeReference]
        private List<int> numbers = new List<int>();

        public override void Initialize()
        {
            base.Initialize();

            /* 初期化ロジック */

            numbers.Add(5);
        }

        public override void Dispose()
        {
            /* 破棄ロジック */

            numbers.Clear();
            numbers = null;

            base.Dispose();
        }
    }
}

GameModeのつくり方

GameInstanceとだいたい同じです。

SampleGameMode.cs
using System;
using System.Collections.Generic;
using UnityEngine;

namespace Assets.Scripts
{
    /* SerializeReferenceのためにSerializableつけてください */
    [Serializable]
    public class SampleGameMode : Tonari.Unity.GameMode
    {
        [SerializeReference]
        private List<int> numbers = new List<int>();

        public override void Initialize()
        {
            base.Initialize();

            /* 初期化ロジック */

            numbers.Add(5);
        }

        public override void Dispose()
        {
            /* 破棄ロジック */

            numbers.Clear();
            numbers = null;

            base.Dispose();
        }
    }
}

設定の仕方

image.png

Windowメニューにこんなのを追加しているので開くと、

image.png

という質素な画面が出てきます。
この質素な画面でGameInstanceと、各シーンに紐づくGameModeを設定します。

プルダウンを押すと

image.png
image.png

さっき作ったGameInstanceやGameModeが出てくるので、選択して設定は終了です。

注意

GameModeを設定するには、設定したいシーンを開いてからGameModeSettingWindowを使用してください。
いったんは雑で、すみません。

寿命と初期化の方法について

GameInstanceとGameModeは、ScriptableObjectに初期値の入ったインスタンスを格納しています。
これはDefaultではResources直下にGameModeSettings.assetとして生成されます。
GameInstanceは起動時や、任意のタイミングでGameInstance.ResetInstance()を呼ぶことで、1つ前のインスタンスをDisposeし、初期インスタンスをディープコピーしてキャッシュします。
GameModeはシーンの読み込み時に初期インスタンスをディープコピーしてキャッシュし、シーンが破棄されるタイミングでDisponseします。

つまり、シーンA→B→Aと移動した場合、最初のAのGameModeインスタンスと最後のAのGameModeインスタンスは別物になります。
ディープコピーされたインスタンスの寿命は完全にシーンの寿命と一致します。

また、ゲーム内でエラーが起こりタイトルに戻った際にGameInstance.ResetInstance()をすることで、エラーの起きている時代のGameInstanceを破棄し、新しいGameInstanceを使用することができます。
マスタの再取得などはこのパターンでできるかと思います。

3
Help us understand the problem. What is going on with this article?
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
yKimisaki
書いてるものは個人の感想です

Comments

No comments
Sign up for free and join this conversation.
Sign Up
If you already have a Qiita account Login
3
Help us understand the problem. What is going on with this article?