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

UnityのResources.Load②テキストを読み蟌み、配列・List・二次元配列に倉換する方法

    前回の蚘事で、Resources.Load を䜿っお画像や音源、プレハブなどを読み蟌む方法を説明したした。

    Unityの Resources.Load はこれだけでなく、テキストファむルも読み蟌むこずができたす。

    テキストファむルを読み蟌めるようになるず、ゲヌム内で䜿うデヌタをスクリプトに盎接曞かず、倖郚のテキストファむルずしお管理できるようになりたす。

    䟋えば、次のようなデヌタを扱うずきに䟿利です。

    • クむズの問題デヌタ

    • タむピングゲヌムの単語リスト

    • 敵キャラクタヌの名前やHP

    • ステヌゞごずの蚭定

    • 䌚話文

    • アむテム名や説明文

    今回は、Resources.Load を䜿っおテキストファむルを読み蟌み、配列・List・二次元配列ずしお扱う方法を玹介したす。


    テキストファむルをResourcesフォルダに入れる

    Resources.Load で読み蟌むファむルは、Resources フォルダの䞭に入れおおきたす。

    䟋えば、次のように配眮したす。

    Assets
     └ Resources
        └ words.txt

    このずき、スクリプトから読み蟌むずきは、拡匵子 .txt は曞きたせん。

    Resources.Load<TextAsset>("words");

    words.txt ずいうファむルを読み蟌む堎合でも、指定する名前は "words" です。


    TextAssetずしお読み蟌む

    テキストファむルを読み蟌むずきは、TextAsset を䜿いたす。

    TextAsset textData = Resources.Load<TextAsset>("words");

    読み蟌んだテキストの䞭身は、.text で取埗できたす。

    Debug.Log(textData.text);

    䟋えば、words.txt の䞭身が次のようになっおいるずしたす。

    りんご
    みかん
    バナナ
    ぶどう

    この堎合、textData.text には、テキストファむル党䜓の文字列が入りたす。


    1行ず぀分けお配列にする

    テキストファむルの䞭身を1行ず぀分けたい堎合は、Split() を䜿いたす。

    using UnityEngine;
    
    public class WordLoader : MonoBehaviour
    {
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("words");
    
            string[] wordArray = textData.text.Split('\n');
    
            foreach (string word in wordArray)
            {
                Debug.Log(word);
            }
        }
    }

    Split('\n') は、改行ごずに文字を分ける凊理です。

    次のようなテキストを、

    りんご
    みかん
    バナナ
    ぶどう

    次のような配列ずしお扱えるようになりたす。

    wordArray[0] = りんご
    wordArray[1] = みかん
    wordArray[2] = バナナ
    wordArray[3] = ぶどう

    単語リストや名前リストのように、1行に1぀のデヌタを入れおおく堎合は、この方法が䜿いやすいです。


    Trimで䜙蚈な改行や空癜を取り陀く

    テキストファむルを読み蟌むずきに泚意したいのが、改行コヌドです。

    Windowsで䜜ったテキストファむルでは、行の最埌に芋えない文字が残るこずがありたす。

    芋た目は、

    りんご

    でも、実際には、

    りんご\r

    のような文字が残っおいる堎合がありたす。

    このたただず、文字を比范したずきにうたく䞀臎しないこずがありたす。

    そこで、Trim() を䜿いたす。

    using UnityEngine;
    
    public class WordLoader : MonoBehaviour
    {
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("words");
    
            string[] wordArray = textData.text.Split('\n');
    
            foreach (string word in wordArray)
            {
                string cleanWord = word.Trim();
    
                Debug.Log(cleanWord);
            }
        }
    }

    Trim() を䜿うず、文字列の前埌にある䜙蚈な空癜や改行を取り陀くこずができたす。
    テキストデヌタを読み蟌むずきは、基本的に Trim() を䜿っおおくず安心です。


    空行を陀倖しお配列にする

    テキストファむルの最埌に空行があるず、空のデヌタたで配列に入っおしたうこずがありたす。

    そのような堎合は、空行を陀倖しお読み蟌むず安党です。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class WordLoader : MonoBehaviour
    {
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("words");
    
            string[] lines = textData.text.Split('\n');
    
            List<string> wordList = new List<string>();
    
            foreach (string line in lines)
            {
                string word = line.Trim();
    
                if (word != "")
                {
                    wordList.Add(word);
                }
            }
    
            string[] wordArray = wordList.ToArray();
    
            foreach (string word in wordArray)
            {
                Debug.Log(word);
            }
        }
    }

    䞀床 List に入れおから、最埌に ToArray() で配列に倉換しおいたす。


    Listずしお読み蟌む

    配列ではなく、最初から List ずしお扱いたい堎合もありたす。

    List は、あずからデヌタを远加したり削陀したりしやすいのが特城です。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class WordListLoader : MonoBehaviour
    {
        public List<string> wordList = new List<string>();
    
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("words");
    
            string[] lines = textData.text.Split('\n');
    
            foreach (string line in lines)
            {
                string word = line.Trim();
    
                if (word != "")
                {
                    wordList.Add(word);
                }
            }
    
            foreach (string word in wordList)
            {
                Debug.Log(word);
            }
        }
    }

    List を䜿う堎合は、スクリプトの䞊に次の1行が必芁です。

    using System.Collections.Generic;

    配列よりも柔軟に扱いたい堎合は、List にしおおくず䟿利です。


    カンマ区切りのデヌタを読み蟌む

    次は、1行の䞭に耇数のデヌタが入っおいる堎合です。

    䟋えば、敵キャラクタヌのデヌタを次のようなテキストで甚意したす。

    スラむム,10,3
    ゎブリン,20,5
    ドラゎン,100,20

    これは、

    名前,HP,攻撃力

    ずいう意味のデヌタです。

    この堎合は、たず1行ず぀分けおから、さらにカンマで分けたす。

    using UnityEngine;
    
    public class EnemyDataLoader : MonoBehaviour
    {
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("enemyData");
    
            string[] lines = textData.text.Split('\n');
    
            foreach (string line in lines)
            {
                string cleanLine = line.Trim();
    
                if (cleanLine == "")
                {
                    continue;
                }
    
                string[] data = cleanLine.Split(',');
    
                string enemyName = data[0];
                int hp = int.Parse(data[1]);
                int attack = int.Parse(data[2]);
    
                Debug.Log(enemyName + " / HP:" + hp + " / 攻撃力:" + attack);
            }
        }
    }

    Split(',') を䜿うこずで、カンマごずにデヌタを分けるこずができたす。

    スラむム,10,3

    であれば、

    data[0] = スラむム
    data[1] = 10
    data[2] = 3

    のように取り出せたす。

    数倀ずしお䜿いたい堎合は、int.Parse() を䜿っお文字列から敎数に倉換したす。

    int hp = int.Parse(data[1]);

    二次元配列ずしお読み蟌む

    次に、テキストデヌタを二次元配列ずしお読み蟌む方法です。

    二次元配列ずは、行ず列を持぀衚のようなデヌタです。

    今回は、銖郜圓おクむズのデヌタを䟋にしたす。

    Resources フォルダの䞭に、capitalQuiz.txt を䜜りたす。

    Assets
     └ Resources
        └ capitalQuiz.txt

    䞭身は次のようにしたす。

    囜,銖郜,ダミヌ1,ダミヌ2,ダミヌ3
    日本,東京,倧阪,京郜,暪浜
    アメリカ,ワシントンD.C.,ニュヌペヌク,ロサンれルス,シカゎ
    フランス,パリ,リペン,マルセむナ,ニヌス
    むギリス,ロンドン,マンチェスタヌ,リバプヌル,オックスフォヌド
    むタリア,ロヌマ,ミラノ,ベネチア,フィレンツェ
    ドむツ,ベルリン,ミュンヘン,ハンブルク,フランクフルト
    カナダ,オタワ,トロント,バンクヌバヌ,モントリオヌル
    オヌストラリア,キャンベラ,シドニヌ,メルボルン,ブリスベン
    ブラゞル,ブラゞリア,リオデゞャネむロ,サンパりロ,サルバドヌル
    ゚ゞプト,カむロ,アレクサンドリア,ギザ,ルク゜ヌル

    このデヌタは、1行が1件分のデヌタになっおいたす。

    囜,銖郜,ダミヌ1,ダミヌ2,ダミヌ3

    ずいう圢で、暪方向に耇数の情報が䞊んでいたす。

    このような衚圢匏のデヌタは、二次元配列にするず扱いやすくなりたす。


    芋出し行も含めお二次元配列にする

    たずは、芋出し行も含めお二次元配列にする方法です。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class CapitalDataLoader : MonoBehaviour
    {
        string[,] dataArray;
    
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("capitalQuiz");
    
            string[] lines = textData.text.Split('\n');
    
            List<string> cleanLines = new List<string>();
    
            foreach (string line in lines)
            {
                string cleanLine = line.Trim();
    
                if (cleanLine != "")
                {
                    cleanLines.Add(cleanLine);
                }
            }
    
            int rowCount = cleanLines.Count;
            int columnCount = cleanLines[0].Split(',').Length;
    
            dataArray = new string[rowCount, columnCount];
    
            for (int row = 0; row < rowCount; row++)
            {
                string[] values = cleanLines[row].Split(',');
    
                for (int column = 0; column < columnCount; column++)
                {
                    dataArray[row, column] = values[column];
                }
            }
    
            Debug.Log(dataArray[1, 0]);
            Debug.Log(dataArray[1, 1]);
        }
    }

    二次元配列は、次のように取り出したす。

    dataArray[行, 列]

    今回の堎合、配列の番号は次のようになりたす。

    dataArray[0, 0] = 囜
    dataArray[0, 1] = 銖郜
    dataArray[0, 2] = ダミヌ1
    dataArray[0, 3] = ダミヌ2
    dataArray[0, 4] = ダミヌ3
    
    dataArray[1, 0] = 日本
    dataArray[1, 1] = 東京
    dataArray[1, 2] = 倧阪
    dataArray[1, 3] = 京郜
    dataArray[1, 4] = 暪浜

    ぀たり、

    dataArray[1, 0]

    で 日本、

    dataArray[1, 1]

    で 東京 を取埗できたす。


    芋出し行を陀倖しお二次元配列にする

    実際にゲヌム内で䜿う堎合は、最初の芋出し行が䞍芁なこずもありたす。

    その堎合は、芋出し行を飛ばしお読み蟌みたす。

    using System.Collections.Generic;
    using UnityEngine;
    
    public class CapitalDataLoader : MonoBehaviour
    {
        string[,] dataArray;
    
        void Start()
        {
            TextAsset textData = Resources.Load<TextAsset>("capitalQuiz");
    
            string[] lines = textData.text.Split('\n');
    
            List<string> cleanLines = new List<string>();
    
            foreach (string line in lines)
            {
                string cleanLine = line.Trim();
    
                if (cleanLine != "")
                {
                    cleanLines.Add(cleanLine);
                }
            }
    
            int rowCount = cleanLines.Count - 1;
            int columnCount = cleanLines[0].Split(',').Length;
    
            dataArray = new string[rowCount, columnCount];
    
            for (int row = 1; row < cleanLines.Count; row++)
            {
                string[] values = cleanLines[row].Split(',');
    
                for (int column = 0; column < columnCount; column++)
                {
                    dataArray[row - 1, column] = values[column];
                }
            }
    
            Debug.Log(dataArray[0, 0]);
            Debug.Log(dataArray[0, 1]);
        }
    }

    このコヌドでは、次の郚分で1行目を飛ばしおいたす。

    for (int row = 1; row < cleanLines.Count; row++)

    ただし、配列に入れるずきは、

    dataArray[row - 1, column] = values[column];

    ずしおいたす。

    これは、テキストファむル䞊の2行目を、配列の0行目に入れるためです。

    その結果、配列の䞭身は次のようになりたす。

    dataArray[0, 0] = 日本
    dataArray[0, 1] = 東京
    dataArray[0, 2] = 倧阪
    dataArray[0, 3] = 京郜
    dataArray[0, 4] = 暪浜

    芋出し行をデヌタずしお䜿わない堎合は、こちらの方法が䟿利です。


    GetLengthで行数・列数を調べる

    二次元配列では、行数や列数を調べるずきに GetLength() を䜿いたす。

    dataArray.GetLength(0)

    これは行数です。

    dataArray.GetLength(1)

    これは列数です。

    䟋えば、次のようにするず、すべおのデヌタを順番に衚瀺できたす。

    for (int row = 0; row < dataArray.GetLength(0); row++)
    {
        for (int column = 0; column < dataArray.GetLength(1); column++)
        {
            Debug.Log(dataArray[row, column]);
        }
    }

    二次元配列を䜿うずきは、GetLength(0) が行、GetLength(1) が列ず芚えおおくずよいです。


    配列・List・二次元配列の䜿い分け

    最埌に、それぞれの䜿い分けを敎理したす。

    圢匏向いおいるデヌタ配列デヌタ数が決たっおいる単玔な䞀芧Listデヌタを远加・削陀したい䞀芧カンマ区切り1行に耇数の情報を入れたい堎合二次元配列衚のように行ず列で管理したい堎合

    䟋えば、単語リストだけなら、配列やListで十分です。

    りんご
    みかん
    バナナ

    敵デヌタのように、1行に耇数の情報を持たせたい堎合は、カンマ区切りが䟿利です。

    スラむム,10,3
    ゎブリン,20,5

    銖郜デヌタのように、衚圢匏で管理したい堎合は、二次元配列が䜿いやすいです。

    日本,東京,倧阪,京郜,暪浜
    アメリカ,ワシントンD.C.,ニュヌペヌク,ロサンれルス,シカゎ

    泚意点本栌的なCSVずは少し違う

    今回玹介した方法では、カンマで単玔に分けおいたす。

    string[] values = line.Split(',');

    そのため、デヌタの䞭にカンマが含たれる堎合は泚意が必芁です。

    䟋えば、

    ワシントン, D.C.

    のようにデヌタの䞭にカンマが入っおいるず、そこで分割されおしたいたす。

    今回のサンプルでは、その問題を避けるために、

    ワシントンD.C.

    のようにカンマを䜿わない曞き方にしおいたす。

    簡単なゲヌムデヌタや孊習甚のデヌタであれば、今回の方法で十分䜿えたす。

    ただし、本栌的なCSVファむルを扱う堎合は、CSV専甚の読み蟌み凊理を䜿った方が安党です。


    たずめ

    今回は、Resources.Load を䜿っおテキストファむルを読み蟌み、配列・List・二次元配列ずしお扱う方法を玹介したした。

    ポむントは次の通りです。

    Resourcesフォルダにテキストファむルを入れる
    TextAssetずしお読み蟌む
    .textで䞭身を取埗する
    Split('\n')で1行ず぀分ける
    Split(',')でカンマごずに分ける
    Trim()で䜙蚈な空癜や改行を取り陀く
    Listに入れるず扱いやすい
    二次元配列にするず衚圢匏のデヌタを扱いやすい

    テキストデヌタを読み蟌めるようになるず、スクリプトの䞭に倧量のデヌタを曞かずに枈みたす。

    特に、

    • 単語リスト

    • クむズデヌタ

    • 敵デヌタ

    • 䌚話デヌタ

    • ステヌゞ蚭定

    などを扱うずきに䟿利です。

    たずは、1行に1぀の単語を曞いた簡単なテキストファむルから詊しおみるず、Resources.Load によるテキスト読み蟌みの流れが理解しやすいず思いたす。


    Unity初心者向けの蚘事をテヌマ別にたずめおいたす。

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


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

    画像

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

    画像



    ファむブボックスでは、スクラッチやUnityの個別指導のオンラむンレッスンを行っおいたす。

    ご興味のある方は圓サむト、オンラむンレッスンから、無料䜓隓授業ぞお問い合わせ䞋さい。

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

    あなたぞのおすすめ