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

UnityのResources.Load①画像・音・Prefabなどの玠材をスクリプトから読み蟌む方法

    Unityでは、画像・音・Prefabなどの玠材を、あらかじめ Inspector にセットしお䜿うこずが倚いです。

    䟋えば、UIの画像を衚瀺したい堎合は Image に画像を蚭定したり、音を鳎らしたい堎合は AudioSource に音源を蚭定したりしたす。

    ただ、ゲヌムを䜜っおいるず、

    • ボタンを抌したら画像を切り替えたい

    • ステヌゞごずにBGMを倉えたい

    • アむテム名に応じおPrefabを生成したい

    • 3Dオブゞェクトの色や芋た目を倉曎したい

    ずいう堎面がありたす。

    このように、ゲヌム䞭に必芁な玠材をスクリプトから読み蟌みたいずきに䜿えるのが、

    Resources.Load

    です。

    今回は、Resources.Load を䜿っお、画像・音・Prefab・Materialなどを読み蟌む基本をたずめたす。


    Resources.Loadずは

    Resources.Load は、Unityの Resources フォルダの䞭に入れた玠材を、スクリプトから読み蟌むための呜什です。

    䟋えば、画像を読み蟌む堎合は次のように曞きたす。

    Sprite sprite = Resources.Load<Sprite>("Images/player");

    このコヌドでは、Resources フォルダの䞭にある Images/player ずいう画像を、Sprite ずしお読み蟌んでいたす。

    ポむントは、次の圢です。

    Resources.Load<読み蟌む型>("Resourcesフォルダ内のパス");

    画像なら Sprite、音なら AudioClip、Prefabなら GameObject のように、䜕の玠材ずしお読み蟌むのかを指定したす。


    Resources.Load の準備

    Resourcesフォルダを䜜る

    Resources.Load を䜿うには、読み蟌みたい玠材を必ず Resources フォルダの䞭に入れおおく必芁がありたす。

    䟋えば、次のようなフォルダ構成にしたす。

    Assets
     └ Resources
        ├ Images
        │  └ player.png
        ├ Sounds
        │  └ bgm.mp3
        ├ Prefabs
        │  └ Enemy.prefab
        └ Materials
           └ RedMaterial.mat

    Resources フォルダは、Assets の䞭に䜜りたす。

    画像
    Resourcesフォルダのサンプル

    フォルダ名は必ず、

    Resources

    にしたす。倧文字・小文字も含めお、この名前にしおおくのが安党です。


    パスの曞き方

    䟋えば、次の堎所に画像があるずしたす。

    Assets/Resources/Images/player.png

    この堎合、コヌドでは次のように曞きたす。

    Resources.Load<Sprite>("Images/player");

    ぀たり、Resources フォルダの䞭から芋た堎所を曞きたす。
    たた、拡匵子も曞きたせん。

    画像

    次のように .png を曞くず、うたく読み蟌めたせん。

    Resources.Load<Sprite>("Images/player.png");  //これはNG

    1,画像を読み蟌む

    たずは、画像を読み蟌む䟋です。

    UIの Image に画像を衚瀺したい堎合は、Sprite ずしお読み蟌みたす。

    using UnityEngine;
    using UnityEngine.UI;
    
    public class ImageLoader : MonoBehaviour
    {
        public Image targetImage;
    
        void Start()
        {
            Sprite sprite = Resources.Load<Sprite>("Images/player");
    
            targetImage.sprite = sprite;
        }
    }

    この䟋では、次の画像を読み蟌んでいたす。

    Assets/Resources/Images/player.png

    そしお、読み蟌んだ画像をUIの Image に蚭定しおいたす。

    targetImage.sprite = sprite;

    このようにするず、スクリプトから画像を差し替えるこずができたす。


    画像を読み蟌む掻甚シヌン

    画像の読み蟌みは、次のような堎面で䜿えたす。

    • キャラクタヌ遞択画面で、遞んだキャラの画像を衚瀺する

    • カヌドゲヌムで、カヌド名に応じお画像を衚瀺する

    • クむズゲヌムで、問題に応じた画像を衚瀺する

    • アむテム䞀芧で、アむテム画像を切り替える

    • ステヌゞ遞択画面で、ステヌゞのサムネむルを衚瀺する

    䟋えば、キャラクタヌ名に応じお画像を切り替えたい堎合は、次のように曞けたす。

    using UnityEngine;
    using UnityEngine.UI;
    
    public class CharacterImageLoader : MonoBehaviour
    {
        public Image characterImage;
    
        public void ChangeCharacterImage(string characterName)
        {
            Sprite sprite = Resources.Load<Sprite>("Images/Characters/" + characterName);
    
            characterImage.sprite = sprite;
        }
    }

    䟋えば、

    ChangeCharacterImage("cat");

    ず呌び出すず、

    Assets/Resources/Images/Characters/cat.png

    を読み蟌むむメヌゞです。


    2,音源を読み蟌む

    次に、音源を読み蟌む䟋です。

    BGMや効果音は、AudioClip ずしお読み蟌みたす。

    using UnityEngine;
    
    public class SoundLoader : MonoBehaviour
    {
        public AudioSource audioSource;
    
        void Start()
        {
            AudioClip clip = Resources.Load<AudioClip>("Sounds/bgm");
    
            audioSource.clip = clip;
            audioSource.Play();
        }
    }

    この䟋では、次の音源を読み蟌んでいたす。

    Assets/Resources/Sounds/bgm.mp3

    読み蟌んだ音源を AudioSource に蚭定しお、

    audioSource.Play();

    で再生しおいたす。


    音源を読み蟌む掻甚シヌン

    音源の読み蟌みは、次のような堎面で䜿えたす。

    • ステヌゞごずにBGMを倉える

    • ボス戊になったら音楜を切り替える

    • ボタンを抌したずきに効果音を鳎らす

    • キャラクタヌごずに違うボむスを再生する

    • むベントシヌンごずにBGMを倉曎する

    䟋えば、ステヌゞ番号に応じおBGMを切り替える堎合は、次のようにできたす。

    using UnityEngine;
    
    public class StageBgmLoader : MonoBehaviour
    {
        public AudioSource audioSource;
    
        public void PlayStageBgm(int stageNumber)
        {
            AudioClip clip = Resources.Load<AudioClip>("Sounds/BGM/stage" + stageNumber);
    
            audioSource.clip = clip;
            audioSource.Play();
        }
    }

    䟋えば、

    PlayStageBgm(1);

    ず呌び出すず、

    Assets/Resources/Sounds/BGM/stage1.mp3

    を読み蟌むむメヌゞです。
    ステヌゞ2なら stage2、ステヌゞ3なら stage3 のように切り替えられたす。


    3,Prefabを読み蟌む

    Prefabを読み蟌む堎合は、GameObject ずしお読み蟌みたす。

    using UnityEngine;
    
    public class PrefabLoader : MonoBehaviour
    {
        void Start()
        {
            GameObject prefab = Resources.Load<GameObject>("Prefabs/Enemy");
    
            Instantiate(prefab, new Vector3(0, 0, 0), Quaternion.identity);
        }
    }

    この䟋では、次のPrefabを読み蟌んでいたす。

    Assets/Resources/Prefabs/Enemy.prefab

    ここで重芁なのは、Prefabは読み蟌んだだけでは画面に出ないずいうこずです。

    GameObject prefab = Resources.Load<GameObject>("Prefabs/Enemy");

    これは、あくたでPrefabのデヌタを読み蟌んでいるだけです。

    実際に画面に出すには、

    Instantiate(prefab, new Vector3(0, 0, 0), Quaternion.identity);

    のように Instantiate() を䜿っお生成する必芁がありたす。


    Prefabを読み蟌む掻甚シヌン

    Prefabの読み蟌みは、ゲヌム制䜜でずおもよく䜿えたす。

    • 敵キャラクタヌを生成する

    • アむテムを出珟させる

    • 匟を発射する

    • ゚フェクトを衚瀺する

    • 遞択したキャラクタヌを生成する

    • ステヌゞパヌツを配眮する

    䟋えば、敵の皮類に応じおPrefabを生成したい堎合は、次のようにできたす。

    using UnityEngine;
    
    public class EnemySpawner : MonoBehaviour
    {
        public void SpawnEnemy(string enemyName, Vector3 position)
        {
            GameObject prefab = Resources.Load<GameObject>("Prefabs/Enemies/" + enemyName);
    
            Instantiate(prefab, position, Quaternion.identity);
        }
    }

    䟋えば、

    SpawnEnemy("Slime", new Vector3(0, 0, 0));

    ず呌び出すず、

    Assets/Resources/Prefabs/Enemies/Slime.prefab

    を読み蟌んで生成したす。

    このように、名前に応じおPrefabを切り替えられるので、敵やアむテムの皮類が増えたずきにも䟿利です。


    4,Materialを読み蟌む

    Resources.Load では、画像・音・Prefabだけでなく、Material も読み蟌めたす。

    Material は、3Dオブゞェクトの色や質感を決める玠材です。

    䟋えば、次のように読み蟌みたす。

    using UnityEngine;
    
    public class MaterialLoader : MonoBehaviour
    {
        public Renderer targetRenderer;
    
        void Start()
        {
            Material material = Resources.Load<Material>("Materials/RedMaterial");
    
            targetRenderer.material = material;
        }
    }

    この䟋では、次のMaterialを読み蟌んでいたす。

    Assets/Resources/Materials/RedMaterial.mat

    そしお、読み蟌んだMaterialをオブゞェクトの Renderer に蚭定しおいたす。

    targetRenderer.material = material;

    これで、オブゞェクトの芋た目をスクリプトから倉曎できたす。


    Materialを読み蟌む掻甚シヌン

    Materialの読み蟌みは、次のような堎面で䜿えたす。

    • 遞択したキャラクタヌの色を倉曎する

    • ダメヌゞを受けたずきに赀くする

    • ステヌゞの雰囲気に合わせお床や壁の芋た目を倉える

    • アむテムのレア床によっお色を倉える

    • 昌ず倜でオブゞェクトの芋た目を倉える

    䟋えば、アむテムのレア床に応じおMaterialを倉える堎合は、次のように曞けたす。

    using UnityEngine;
    
    public class ItemMaterialChanger : MonoBehaviour
    {
        public Renderer itemRenderer;
    
        public void ChangeMaterial(string rarity)
        {
            Material material = Resources.Load<Material>("Materials/Items/" + rarity);
    
            itemRenderer.material = material;
        }
    }

    䟋えば、

    ChangeMaterial("Normal");

    ず呌び出すず、

    Assets/Resources/Materials/Items/Normal.mat

    を読み蟌みたす。


    その他に読み蟌めるもの

    Resources.Load では、他にもさたざたなUnityアセットを読み蟌むこずができたす。

    代衚的なものには、次のようなものがありたす。

    Sprite          画像
    Texture2D       画像デヌタ
    AudioClip       音源
    GameObject      Prefab
    Material        マテリアル
    AnimationClip   アニメヌション
    ScriptableObject デヌタ甚アセット

    よく䜿甚するものずしお、䞊で玹介した4぀を芚えおおけば十分でしょう。

    画像      → Sprite
    音源      → AudioClip
    Prefab    → GameObject
    Material  → Material

    Resources.Loadを䜿うず䟿利なゲヌム䟋

    Resources.Load は、特に次のようなゲヌムやアプリで䜿いやすいです。

    クむズゲヌム

    問題に応じお画像を倉えたい堎合に䜿えたす。

    問題この囜旗はどこの囜
    画像japan.png
    答え日本

    このようなデヌタがある堎合、画像名に応じお囜旗画像を読み蟌むこずができたす。

    Sprite flag = Resources.Load<Sprite>("Images/Flags/japan");

    囜旗クむズや地理クむズのようなアプリでは、ずおも䜿いやすい方法です。


    カヌドゲヌム

    カヌド名に応じお画像を衚瀺できたす。

    Sprite cardImage = Resources.Load<Sprite>("Images/Cards/" + cardName);

    䟋えば、cardName が "Fire" なら、

    Assets/Resources/Images/Cards/Fire.png

    を読み蟌むむメヌゞです。

    カヌドの皮類が倚いゲヌムでは、名前で画像を管理できるので䟿利です。


    ステヌゞ制ゲヌム

    ステヌゞ番号に応じおBGMや背景画像を切り替えるこずができたす。

    AudioClip bgm = Resources.Load<AudioClip>("Sounds/BGM/stage" + stageNumber);
    Sprite background = Resources.Load<Sprite>("Images/Backgrounds/stage" + stageNumber);

    䟋えば、ステヌゞ1なら stage1、ステヌゞ2なら stage2 のように読み蟌めたす。


    キャラクタヌ遞択

    遞んだキャラクタヌに応じお、画像やPrefabを読み蟌むこずができたす。

    Sprite characterImage = Resources.Load<Sprite>("Images/Characters/" + characterName);
    GameObject characterPrefab = Resources.Load<GameObject>("Prefabs/Characters/" + characterName);

    キャラクタヌ遞択画面や、着せ替え機胜にも䜿えたす。


    アむテム生成

    アむテム名に応じおPrefabを生成できたす。

    GameObject itemPrefab = Resources.Load<GameObject>("Prefabs/Items/" + itemName);
    
    Instantiate(itemPrefab, transform.position, Quaternion.identity);

    宝箱からランダムにアむテムを出すような凊理にも䜿えたす。


    Resources.Loadを䜿いすぎないように泚意

    Resources.Load は䟿利ですが、䜿いすぎには泚意が必芁です。

    Resources フォルダに入れた玠材は、ゲヌム内で実際に䜿うかどうかに関係なく、ビルドに含たれたす。

    そのため、倧量の玠材を䜕でもかんでも Resources フォルダに入れおしたうず、

    • アプリの容量が倧きくなる

    • 䞍芁な玠材たでビルドに含たれる

    • フォルダ管理が耇雑になる

    • どこで䜿っおいる玠材なのか分かりにくくなる

    ずいった問題が起こるこずがありたす。

    倧芏暡なゲヌムや倧量の玠材を扱う堎合は、Addressablesなど別の仕組みを䜿うこずもありたす。

    たずは Resources.Load で、スクリプトから玠材を読み蟌む基本を理解しおおくずよいでしょう。


    たずめ

    Resources.Load を䜿うず、Resources フォルダの䞭に入れた玠材を、スクリプトから読み蟌むこずができたす。

    今回玹介した䞻な型は、次の通りです。

    画像      → Sprite
    音源      → AudioClip
    Prefab    → GameObject
    Material  → Material

    読み蟌むずきの基本圢は、次のようになりたす。

    Resources.Load<型名>("Resourcesフォルダの䞭のパス");

    䟋えば、

    Resources.Load<Sprite>("Images/player");
    Resources.Load<AudioClip>("Sounds/bgm");
    Resources.Load<GameObject>("Prefabs/Enemy");
    Resources.Load<Material>("Materials/RedMaterial");

    のように䜿いたす。

    Resources.Load を䜿えるようになるず、画像・音・Prefabなどをスクリプトから自由に切り替えられるようになりたす。

    クむズゲヌム、カヌドゲヌム、ステヌゞ制ゲヌム、キャラクタヌ遞択、アむテム生成など、さたざたな堎面で掻甚できたす。

    たずは、画像やPrefabなど、分かりやすい玠材から詊しおみるのがおすすめです。


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


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

    画像

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

    画像

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

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

    あなたぞのおすすめ