Zenn
🍣

【リソース管理】IDisposableとDisposeパターン ― Unity C#で安全なリソース解放を行う方法

2025/03/12に公開
C#
Unity
tech

閲覧いただきありがとうございます。はじめまして、ゲーム開発所RYURYUの「りゅうや」と申します。

❏ ゲーム開発ランキング【 1位 】実績多数 (ココナラ)
❏ ココナラ総販売【 220件超 】
❏ GC甲子園2022・東京ゲームショウ2023など出展経験あり

■ Unityを使ったゲーム・VRの受託開発についてのお問い合わせは、Xからお気軽にどうぞ。
https://x.com/RYURYU_GAME_MFG

■ 記事に関するご質問やご意見は、Discordサーバーまでお寄せください。
https://discord.gg/5FwuKCacNy

【リソース管理】IDisposableとDisposeパターン ― Unity C#で安全なリソース解放を行う方法

Unityでの開発において、メモリ管理は非常に重要です。特に、大規模なプロジェクトや長時間実行されるアプリケーションでは、適切なリソース管理が欠かせません。本記事では、C#のIDisposableインターフェースとDisposeパターンを活用して、Unityプロジェクトにおける安全なリソース解放方法について詳しく解説します。

IDisposableとは？

IDisposableは、.NETにおけるリソース管理のためのインターフェースです。主に、アンマネージリソース（ファイルハンドル、ネットワーク接続、データベース接続など）の解放に使用されます。IDisposableを実装することで、明示的にリソースを解放でき、メモリリークを防ぐことが可能です。

IDisposableの基本構造

IDisposableExample.cs
using System;

public class DisposableResource : IDisposable
{
    private bool disposed = false;

    // 公開メソッド
    public void UseResource()
    {
        if (disposed)
            throw new ObjectDisposedException("DisposableResource");
        Console.WriteLine("Resource in use.");
    }

    // IDisposableの実装
    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }

    // 保護されたDisposeメソッド
    protected virtual void Dispose(bool disposing)
    {
        if (!disposed)
        {
            if (disposing)
            {
                // マネージドリソースの解放
            }
            // アンマネージドリソースの解放
            disposed = true;
        }
    }

    // ファイナライザ
    ~DisposableResource()
    {
        Dispose(false);
    }
}

Disposeパターンの実装

Disposeパターンは、IDisposableを正しく実装するための標準的な方法です。このパターンに従うことで、リソースの適切な管理が保証されます。

Disposeパターンのステップ

  1. Disposeメソッドの実装: IDisposableのDisposeメソッドを実装し、リソース解放のロジックを含めます。
  2. 保護されたDisposeメソッドの作成: 実際のリソース解放処理を行うprotectedメソッドを作成します。
  3. ファイナライザの追加: リソースが解放されていない場合に備えてファイナライザを追加します。
  4. GC.SuppressFinalizeの呼び出し: Disposeが呼ばれた場合、ガベージコレクションによるファイナライザの呼び出しを抑制します。

UnityでのIDisposableの活用方法

Unityでは、シーンの切り替えやオブジェクトの生成・破棄などで多くのリソースが使用されます。IDisposableを適切に使用することで、これらのリソースを効率的に管理できます。

シーン遷移時のリソース解放

シーンを遷移する際、不要になったオブジェクトやリソースを確実に解放することが重要です。以下は、シーン遷移時にIDisposableを活用する例です。

SceneTransitionManager.cs
using UnityEngine;

public class SceneTransitionManager : MonoBehaviour
{
    private DisposableResource resource;

    void Start()
    {
        resource = new DisposableResource();
        resource.UseResource();
    }

    void OnDestroy()
    {
        resource.Dispose();
    }
}

メリット・デメリット

メリット

  • メモリリークの防止: 不要なリソースを確実に解放できるため、メモリリークを防止します。
  • リソース管理の一元化: リソース管理が明確になり、コードの可読性が向上します。
  • ガベージコレクションの最適化: 不要なオブジェクトを早期に解放できるため、GCの負担を軽減します。

デメリット

  • 実装の手間: Disposeパターンの正しい実装には手間がかかります。
  • 誤った使用のリスク: Disposeを正しく呼び出さないと、リソースリークが発生する可能性があります。

実装上の注意点

  • Disposeの呼び出しを忘れない: 必ずDisposeメソッドを呼び出してリソースを解放する習慣をつけましょう。
  • ファイナライザの使用を最小限に: ファイナライザはパフォーマンスに影響を与えるため、必要最低限に留めましょう。
  • マネージドとアンマネージドリソースの区別: マネージドリソースはGCが管理しますが、アンマネージドリソースは手動で管理する必要があります。

具体的な活用例

以下は、UnityプロジェクトでIDisposableを活用したリソース管理の具体例です。

リソース管理クラスの実装

ResourceManager.cs
using System;
using UnityEngine;

public class ResourceManager : IDisposable
{
    private bool disposed = false;
    private Texture2D loadedTexture;

    public ResourceManager(string texturePath)
    {
        loadedTexture = LoadTexture(texturePath);
    }

    private Texture2D LoadTexture(string path)
    {
        // テクスチャをロードする処理
        return new Texture2D(2, 2);
    }

    public void UseTexture()
    {
        if (disposed)
            throw new ObjectDisposedException("ResourceManager");
        // テクスチャを使用する処理
    }

    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }

    protected virtual void Dispose(bool disposing)
    {
        if (!disposed)
        {
            if (disposing)
            {
                // マネージドリソースの解放
                if (loadedTexture != null)
                {
                    UnityEngine.Object.Destroy(loadedTexture);
                    loadedTexture = null;
                }
            }
            // アンマネージドリソースがあればここで解放
            disposed = true;
        }
    }

    ~ResourceManager()
    {
        Dispose(false);
    }
}

使用例

ExampleUsage.cs
using UnityEngine;

public class ExampleUsage : MonoBehaviour
{
    private ResourceManager resourceManager;

    void Start()
    {
        resourceManager = new ResourceManager("Assets/Textures/sample.png");
        resourceManager.UseTexture();
    }

    void OnDestroy()
    {
        resourceManager.Dispose();
    }
}

テーブルで見るDisposeパターンの比較

パターン メリット デメリット
IDisposableのみ 実装が簡単 クリーンアップの保証が不十分
Disposeパターン リソースの確実な解放が可能 実装が複雑
ファイナライザのみ 実装が不要な場合がある パフォーマンスに影響を与える

まとめ

IDisposableとDisposeパターンは、Unity開発におけるリソース管理の要です。適切に実装することで、メモリリークを防ぎ、アプリケーションのパフォーマンスと安定性を向上させることができます。特に、大規模なプロジェクトや長時間実行されるアプリケーションでは、これらのパターンを積極的に活用しましょう。

ぜひ、この記事を参考に、あなたのUnityプロジェクトで安全なリソース管理を実践してください！

Unityをもっと極めたい"あなた"へ ― 今すぐスキルアップのチャンス！

1. どこでもUnity教室「無料プラン」

❏ 毎日の質問で即解決｜Unityに関する疑問や悩みは、専用Discordでプロの仲間とシェア！

  • 月額0円 で、テキストで気軽に質問・進捗共有が可能
  • 実績多数のコミュニティで、参加するだけで具体的な課題解決のヒントが手に入る

まずは無料で参加して、あなたのUnity学習を加速させましょう！ 無料でDiscordに参加する]
https://discord.gg/5FwuKCacNy

2. Unity超入門書【1,000円】

Unityスキルを5日間でマスター｜「実践×即戦力」を手に入れる！

  • 130,000文字超の詳細な解説と実例で、初心者でもすぐにUnityの基礎が身につく
  • 実際の成果例：5日間でシンプルな3D FPSゲームを完成
  • 専属講師サポートのオプション付きで、疑問を即解消しながら学習を進められる

まずはこの教材でUnity開発の第一歩を体験してください！ 教材を今すぐ購入する
https://zenn.dev/ryuryu_game/books/fd28de9d8e963a/viewer/0570af

3. Unity超入門完全支援プラン【単発24,800円】

Unityの全てをプロがバックアップ｜教材で学んだ内容を実践サポート！

  • 専属講師による24時間テキスト質問サポート（毎日17:00～21:00の回答）
  • 月2回×60分 または 月1回×120分のビデオチャットで、学習進捗やプロジェクトの具体的な課題を徹底サポート
  • 教材と連携し、実践の現場での疑問や課題をそのまま解決！
  • 限定：1度に最大10名様のみ受付！早期申込で安心のサポート体制を

教材で学んだ知識をさらに深め、実践に活かすならこのプランがおすすめです！ 今すぐ詳細を確認する
https://ryuryu.memberpay.jp/service/item/yjo1sst

4. Unityプロジェクト完全支援プラン【月額48,000円】

Unityプロジェクトを本格サポート｜個人の趣味からプロの現場まで幅広く対応！

  • 専属講師による24時間テキスト質問サポート（毎日17:00～21:00の回答）
  • 月2回×60分のビデオチャットで、プロジェクトの進行状況を細かくサポート
  • Unity開発の一部を代行するサービスが常に20%割引で利用可能
  • 基本操作からエラー対応、プロジェクト設計のアドバイスまで幅広くサポート
  • 専用Discordサーバーでのサポート体制（ご購入後に招待リンクを送付）

個人プロジェクトを着実に進め、より高い成果を求めるあなたに最適なプランです！ 今すぐプロジェクト支援プランを確認する
https://ryuryu.memberpay.jp/plan/item/epeiywt

※ Unity超入門書で学んだ内容を、さらに深く実践に活かしたい方は、完全支援プランとプロジェクト支援プランの併用がおすすめです！

Discussion