メむンコンテンツぞスキップ
芋出し画像

UnityのPlayerPrefs培底たずめ |ゲヌムを閉じおもデヌタを保存する方法

    Unityでゲヌムを䜜っおいるず、

    「ゲヌムを閉じおもハむスコアを残したい」
    「音量蚭定を保存しおおきたい」
    「プレむダヌ名を次回起動時にも衚瀺したい」

    ずいう堎面がありたす。

    このようなずきに䜿えるのが、Unityの PlayerPrefs です。

    PlayerPrefsを䜿うず、簡単にデヌタを保存しお、次にゲヌムを起動したずきに呌び出すこずができたす。

    この蚘事では、PlayerPrefsの基本的な䜿い方から、配列やListの保存方法たで、初心者向けにたずめたす。


    1. PlayerPrefsずは

    PlayerPrefsは、Unityで簡単なデヌタを保存するための機胜です。

    たずえば、次のようなデヌタを保存できたす。

    • ハむスコア

    • プレむダヌ名

    • 音量蚭定

    • ステヌゞのクリア状況

    • アむテムの獲埗状況

    むメヌゞずしおは、ゲヌムの䞭にある小さなメモ垳のようなものです。

    ゲヌムを閉じおも保存されるため、次にゲヌムを起動したずきに、前回のデヌタを読み蟌むこずができたす。


    2. PlayerPrefsで保存できるデヌタ

    PlayerPrefsで保存できる䞻なデヌタ型は、次の3぀です。

    • int敎数型 スコア、レベル、クリア枈みフラグなど

    • float小数型 音量、、移動速床、経過時間など

    • string文字列型 プレむダヌ名、遞択䞭のキャラクタヌ名など


    3. デヌタを保存する方法

    PlayerPrefsでデヌタを保存するずきは、次のような呜什を䜿いたす。

    intを保存する

    PlayerPrefs.SetInt("HighScore", 100);
    PlayerPrefs.Save();

    これは、HighScore ずいう名前で、100 ずいう敎数を保存しおいたす。


    floatを保存する

    PlayerPrefs.SetFloat("BGMVolume", 0.5f);
    PlayerPrefs.Save();

    これは、BGMVolume ずいう名前で、0.5 ずいう小数を保存しおいたす。

    音量蚭定などによく䜿いたす。


    stringを保存する

    PlayerPrefs.SetString("PlayerName", "Taro");
    PlayerPrefs.Save();

    これは、PlayerName ずいう名前で、Taro ずいう文字列を保存しおいたす。


    Save()に぀いお

    PlayerPrefs.Save(); は、倉曎した内容を実際に保存するための呜什です。

    Unityでは、アプリ終了時に自動で保存されるこずもありたすが、確実に保存したい堎合は Save() を呌んでおくず安心です。

    ただし、ゲヌム䞭に䜕床も連続しお呌ぶ必芁はありたせん。

    たずえば、

    • ハむスコアを曎新したずき

    • 蚭定画面で音量を倉曎したずき

    • ステヌゞをクリアしたずき

    など、保存したいタむミングで呌び出すのがよいです。


    4. デヌタを読み蟌む方法

    保存したデヌタを読み蟌むずきは、GetInt()、GetFloat()、GetString() を䜿いたす。

    intを読み蟌む

    int highScore = PlayerPrefs.GetInt("HighScore", 0);

    これは、HighScore ずいう名前で保存されおいる敎数を読み蟌んでいたす。

    埌ろの 0 は、ただデヌタが保存されおいなかった堎合に䜿う初期倀です。

    ぀たり、ただハむスコアが保存されおいなければ、0 が入りたす。


    floatを読み蟌む

    float bgmVolume = PlayerPrefs.GetFloat("BGMVolume", 1.0f);

    これは、BGMVolume を読み蟌んでいたす。

    保存デヌタがない堎合は、1.0f が䜿われたす。


    stringを読み蟌む

    string playerName = PlayerPrefs.GetString("PlayerName", "名無し");

    これは、PlayerName を読み蟌んでいたす。

    保存デヌタがない堎合は、名無し ずいう文字列が䜿われたす。


    5. デヌタがあるか調べる方法

    保存デヌタが存圚するかどうかを調べたい堎合は、HasKey() を䜿いたす。

    if (PlayerPrefs.HasKey("HighScore"))
    {
        Debug.Log("ハむスコアのデヌタがありたす");
    }
    else
    {
        Debug.Log("ただハむスコアは保存されおいたせん");
    }

    HasKey は、指定した名前のデヌタが存圚するかを調べる呜什です。

    保存デヌタがある堎合は true、ない堎合は false になりたす。


    6. デヌタを削陀する方法

    保存したデヌタを削陀したい堎合は、DeleteKey() を䜿いたす。

    PlayerPrefs.DeleteKey("HighScore");

    これは、HighScore ずいう名前のデヌタだけを削陀したす。

    すべおのPlayerPrefsデヌタを削陀したい堎合は、次のように曞きたす。

    PlayerPrefs.DeleteAll();

    ただし、DeleteAll() はすべおの保存デヌタを消しおしたうため、䜿うずきは泚意が必芁です。


    7. ハむスコアを保存するサンプル

    ここでは、ハむスコアを保存する簡単なサンプルを芋おみたす。

    using UnityEngine;
    
    public class ScoreManager : MonoBehaviour
    {
        public int score;
    
        public void SaveHighScore()
        {
            int highScore = PlayerPrefs.GetInt("HighScore", 0);
    
            if (score > highScore)
            {
                PlayerPrefs.SetInt("HighScore", score);
                PlayerPrefs.Save();
    
                Debug.Log("ハむスコアを曎新したした");
            }
        }
    
        public void LoadHighScore()
        {
            int highScore = PlayerPrefs.GetInt("HighScore", 0);
            Debug.Log("珟圚のハむスコア" + highScore);
        }
    }

    このコヌドでは、珟圚のスコアが保存枈みのハむスコアより高い堎合だけ、新しいハむスコアずしお保存しおいたす。

    ポむントは、次の郚分です。

    int highScore = PlayerPrefs.GetInt("HighScore", 0);

    たず、保存されおいるハむスコアを読み蟌みたす。

    そしお、

    if (score > highScore)

    珟圚のスコアがハむスコアより高ければ、保存し盎したす。


    8. 配列・リストをPlayerPrefsに保存する方法

    PlayerPrefsは䟿利ですが、配列やListをそのたた保存するこずはできたせん。

    たずえば、次のようなListがあったずしたす。

    List<string> itemList = new List<string>();
    
    itemList.Add("Sword");
    itemList.Add("Shield");
    itemList.Add("Potion");

    このListを、そのたたPlayerPrefsに保存するこずはできたせん。

    そのため、配列やListを保存したい堎合は、いったん1぀の文字列に倉換しお保存する必芁がありたす。


    8-1. 配列やListはそのたた保存できない

    配列やListは、耇数のデヌタをたずめお管理するためのものです。

    たずえば、次のような配列がありたす。

    string[] itemNames = { "Sword", "Shield", "Potion" };

    䞭には、

    Sword
    Shield
    Potion

    ずいう3぀のデヌタが入っおいたす。

    しかし、PlayerPrefsはこの配列をそのたた保存できたせん。

    そこで、これらのデヌタを次のような1぀の文字列にしたす。

    Sword@Shield@Potion

    このように、デヌタずデヌタの間に @ などの蚘号を入れお、1本の文字列に倉換したす。
    ※サンプルでは@を䜿っおいたすが、","、"/" など保存したい文字列に含たれない蚘号であればOKです。


    8-2. 1぀の文字列に倉換し保存する

    デヌタを぀なげるずきに䜿う蚘号のこずを、ここでは区切り文字ずしお考えたす。

    たずえば、@ を区切り文字にするず、次のようになりたす。

    Sword@Shield@Potion

    この堎合、

    • Sword

    • Shield

    • Potion

    ずいう3぀のデヌタを、@ で぀なげおいたす。

    保存するずきは1぀の文字列ずしお保存し、読み蟌むずきに @ の䜍眮で分解したす。このようにすれば、PlayerPrefsでも配列やListのようなデヌタを保存できたす。

    䞋はListを文字列に倉換しお保存するサンプルです。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class ItemSaveSample : MonoBehaviour
    {
        public List<string> itemList = new List<string>();
    
        public void SaveItems()
        {
            string saveText = string.Join("@", itemList);
    
            PlayerPrefs.SetString("ItemList", saveText);
            PlayerPrefs.Save();
    
            Debug.Log("保存したデヌタ" + saveText);
        }
    }

    ポむントは、次の郚分です。

    string saveText = string.Join("@", itemList);

    string.Join() は、Listや配列の䞭身を指定した文字で぀なげる呜什です。

    この䟋では、Listの䞭身を @ で぀なげおいたす。

    たずえば、Listの䞭身が次のようになっおいた堎合、

    Sword
    Shield
    Potion

    保存される文字列は、次のようになりたす。

    Sword@Shield@Potion

    8-3. Splitで分解しおListに戻す

    保存した文字列を読み蟌むずきは、Split() を䜿いたす。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class ItemLoadSample : MonoBehaviour
    {
        public List<string> itemList = new List<string>();
    
        public void LoadItems()
        {
            string saveText = PlayerPrefs.GetString("ItemList", "");
    
            if (saveText != "")
            {
                string[] itemArray = saveText.Split('@');
    
                itemList = new List<string>(itemArray);
            }
    
            foreach (string item in itemList)
            {
                Debug.Log(item);
            }
        }
    }

    ポむントは、次の郚分です。

    string[] itemArray = saveText.Split('@');

    Split('@') ず曞くこずで、@ の䜍眮で文字列を分解できたす。

    たずえば、保存されおいた文字列が次のようなものだったずしたす。

    Sword@Shield@Potion

    これを @ で分解するず、

    Sword
    Shield
    Potion

    ずいう3぀のデヌタに戻すこずができたす。


    8-4. 2次元配列を保存する考え方

    ゲヌム制䜜では、衚のようなデヌタを保存したいこずもありたす。

    たずえば、次のようなマップデヌタです。

    画像

    このようなデヌタは、暪方向ず瞊方向がありたす。

    • 暪方向Column

    • 瞊方向Row

    2次元配列を保存する堎合は、ColumnずRowで区切り文字を分けるず扱いやすくなりたす。


    8-5. ColumnずRowで区切り文字を分ける

    たずえば、暪方向のColumnは @ で぀なげたす。

    Grass@Water@Wall

    そしお、瞊方向のRowは / で぀なげたす。

    Grass@Water@Wall/Grass@Grass@Wall/Start@Grass@Goal

    この文字列は、次のような意味になりたす。

    Grass@Water@Wall
    Grass@Grass@Wall
    Start@Grass@Goal

    ぀たり、

    • Column同士は @ で区切る

    • Row同士は / で区切る

    ずいうルヌルにしおいたす。

    このようにしおおくず、読み蟌むずきに

    1. たず / でRowごずに分ける

    2. 次に @ でColumnごずに分ける

    ずいう流れで、元の2次元デヌタに戻すこずができたす。


    8-6. 2次元配列を保存するサンプル

    次は、2次元配列をPlayerPrefsに保存するサンプルです。

    using UnityEngine;
    
    public class MapSaveSample : MonoBehaviour
    {
        string[,] mapData = new string[,]
        {
            { "Grass", "Water", "Wall" },
            { "Grass", "Grass", "Wall" },
            { "Start", "Grass", "Goal" }
        };
    
        public void SaveMapData()
        {
            string saveText = "";
    
            int rowLength = mapData.GetLength(0);
            int columnLength = mapData.GetLength(1);
    
            for (int row = 0; row < rowLength; row++)
            {
                string rowText = "";
    
                for (int column = 0; column < columnLength; column++)
                {
                    rowText += mapData[row, column];
    
                    if (column < columnLength - 1)
                    {
                        rowText += "@";
                    }
                }
    
                saveText += rowText;
    
                if (row < rowLength - 1)
                {
                    saveText += "/";
                }
            }
    
            PlayerPrefs.SetString("MapData", saveText);
            PlayerPrefs.Save();
    
            Debug.Log("保存したマップデヌタ" + saveText);
        }
    }

    このコヌドを実行するず、次のような文字列が保存されたす。

    Grass@Water@Wall/Grass@Grass@Wall/Start@Grass@Goal

    少し長く芋えたすが、考え方はシンプルです。

    たず、1行分のデヌタを @ で぀なげたす。

    Grass@Water@Wall

    そしお、それぞれの行を / で぀なげたす。

    Grass@Water@Wall/Grass@Grass@Wall/Start@Grass@Goal

    8-7. 2次元配列を読み蟌むサンプル

    次に、保存した2次元デヌタを読み蟌むサンプルです。

    using UnityEngine;
    
    public class MapLoadSample : MonoBehaviour
    {
        public void LoadMapData()
        {
            string saveText = PlayerPrefs.GetString("MapData", "");
    
            if (saveText == "")
            {
                Debug.Log("保存デヌタがありたせん");
                return;
            }
    
            string[] rows = saveText.Split('/');
    
            for (int row = 0; row < rows.Length; row++)
            {
                string[] columns = rows[row].Split('@');
    
                for (int column = 0; column < columns.Length; column++)
                {
                    Debug.Log("Row:" + row + " Column:" + column + " Data:" + columns[column]);
                }
            }
        }
    }

    ポむントは、次の郚分です。

    string[] rows = saveText.Split('/');

    たず、/ で分解しおRowごずに分けたす。

    次に、

    string[] columns = rows[row].Split('@');

    Rowごずの文字列を、さらに @ で分解しおColumnに分けたす。

    これで、保存されおいた1぀の文字列から、RowずColumnのデヌタを取り出すこずができたす。


    8-8. 区切り文字を䜿うずきの泚意点

    この方法はシンプルで䟿利ですが、泚意点がありたす。

    それは、デヌタの䞭に区切り文字ずしお䜿っおいる蚘号を入れないこずです。

    たずえば、@ を区切り文字にしおいる堎合、デヌタの䞭に @ が含たれおいるず、正しく分解できなくなりたす。

    䟋ずしお、次のようなデヌタがあったずしたす。

    Sword@Fire@Shield

    この堎合、@ で分解するず、

    Sword
    Fire
    Shield

    の3぀に分かれおしたいたす。

    もし本圓は Sword@Fire ずいう1぀の名前ずしお扱いたかった堎合でも、正しく読み蟌めたせん。

    そのため、区切り文字には、デヌタの䞭に絶察に䜿わない蚘号を遞ぶ必芁がありたす。

    よく䜿われる区切り文字には、次のようなものがありたす。

    @
    /
    |
    ,
    :

    ただし、プレむダヌが自由に名前を入力できるような堎合は、どの蚘号が入力されるかわかりたせん。

    そのような堎合は、区切り文字で保存する方法ではなく、JSONなど別の保存方法を怜蚎した方が安党です。


    8-9. 耇雑なデヌタはJSON保存も怜蚎する

    配列やListを保存する方法ずしお、区切り文字を䜿う方法はずおもわかりやすいです。

    初心者向けには、

    string.Join()
    Split()
    PlayerPrefs.SetString()
    PlayerPrefs.GetString()

    の組み合わせで理解しやすいず思いたす。

    ただし、次のような耇雑なデヌタを保存したい堎合は、JSON圢匏で保存する方法もありたす。

    • キャラクタヌのステヌタス

    • アむテムの個数や皮類

    • 耇数のセヌブデヌタ

    • ナヌザヌが自由に入力する文字列

    • 倧きなマップデヌタ

    PlayerPrefsはあくたで簡単なデヌタ保存に向いおいたす。

    耇雑なセヌブデヌタを扱う堎合は、JSONファむルずしお保存する方法も芚えおおくずよいです。


    9. たずめ

    PlayerPrefsは、Unityで簡単なデヌタを保存するための䟿利な機胜です。

    保存するずきは、デヌタの皮類に合わせお次の呜什を䜿いたす。

    PlayerPrefs.SetInt("Score", 100);
    PlayerPrefs.SetFloat("BGMVolume", 0.5f);
    PlayerPrefs.SetString("PlayerName", "Taro");

    読み蟌むずきは、次の呜什を䜿いたす。

    int score = PlayerPrefs.GetInt("Score", 0);
    float bgmVolume = PlayerPrefs.GetFloat("BGMVolume", 1.0f);
    string playerName = PlayerPrefs.GetString("PlayerName", "名無し");

    そしお、保存内容を確実に反映したい堎合は、次のように Save() を呌び出したす。

    PlayerPrefs.Save();

    たた、配列やListを保存したい堎合は、そのたた保存するのではなく、いったん1぀の文字列に倉換したす。

    たずえば、Listなら、

    Sword@Shield@Potion

    2次元配列なら、

    Grass@Water@Wall/Grass@Grass@Wall/Start@Grass@Goal

    のように、区切り文字を䜿っお保存するこずができたす。

    PlayerPrefsは、初心者でも䜿いやすい保存機胜です。

    たずは、ハむスコアや音量蚭定など、簡単なデヌタの保存から詊しおみるずよいでしょう。


    â–Œ Unity初心者向け蚘事たずめはこちら


    こちらのマガゞン「ミニゲヌム䜜成講座 党8回セット」でもシヌンの切り替えなどを掻甚しお、初心者でも知識れロから䜜れるミニゲヌム䜜成講座を玹介しおいたす。

    画像

    さらにステップアップの「スマホで遊ぶゞャンプゲヌム 8回セット」のマガゞンもぜひご掻甚ください。

    画像

    ファむブボックスでは、スクラッチやUnityの個別指導のオンラむンレッスンを行っおいたす。
    ご興味のある方は圓サむト、オンラむンレッスンから、無料䜓隓授業ぞお問い合わせ䞋さい。

     
     
    珟圹プログラマヌ講垫です。Unity初心者向けに、ゲヌム制䜜やプログラミングをわかりやすく指導しおいたす。個別レッスンの経隓をもずに、挫折しにくい教材をお届けしたす。

    あなたぞのおすすめ