マネージプラグイン
マネージプラグインの使用に関する詳細。
読み終わるまでの所要時間 14 分最終更新 5日前
マネージプラグインは、Unity の外部で作成およびコンパイルし、Visual Studio などのツールでダイナミックリンクライブラリ (DLL) にする .NET アセンブリです。
これは、Unity が Unity プロジェクトの Assets フォルダーにソースファイルとして保存する標準の C# スクリプトとは異なるプロセスです。Unityは、標準のC#スクリプトが変更されるたびにコンパイルしますが、DLLは事前コンパイルされ、変更されません。標準のスクリプトと同じ方法で、コンパイルされた .dll ファイルをプロジェクトに追加し、そこに含まれるクラスを GameObjects にアタッチ、設定、添付できます。
C# のマネージコードの詳細については、Microsoft のドキュメント「What is マネージコード?」を参照してください。
マネージプラグインには .NET コードのみが含まれているため、.NET ライブラリがサポートしない機能にアクセスすることはできません。ただし、マネージコードは、Unity がスクリプトのコンパイルに使用する標準の .NET ツールにアクセスできます。
Unity で DLL を使用する場合、スクリプトを使用する場合よりも多くの手順を実行する必要があります。ただし、代わりに .dll ファイルを作成して Unity プロジェクトに追加すると便利な場合があります。例えば、
- Unity がサポートしないコンパイラをコードで使用する。
- サードパーティの .NET コードを .dll ファイルに追加する。
- ソースなしで Unity にコードを提供する。
このページでは、マネージプラグインの作成に使用できる一般的なメソッドと、Visual Studio を使用してマネージプラグインを作成し、デバッグセッションを設定する方法について説明します。
マネージプラグインの作成
マネージプラグインを作成するには、DLL を作成する必要があります。これを行うには、次のような適切なコンパイラーが必要です。
.NET コードを生成するすべてのコンパイラーが Unity と互換性のあるわけではないため、コンパイラーで重要な作業を行う前に、使用可能なコードでコンパイラーをテストする必要があります。Unityが現在サポートしている.NETプロファイルについては、.NETプロファイル サポートを参照してください。
DLL の作成に使用するメソッドは、DLL に Unity API コードが含まれているかどうかによって異なります。
-
DLL に Unity API コードが含まれている場合は、コンパイル前に Unity 独自の DLL をコンパイラーで使用可能にする必要があります。
-
Unity DLL を検索するには、以下を行います。
-
Windows では、に移動します。
C:\Program Files\Unity\Hub\Editor\<version-number>\Editor\Data\Managed -
macOS の場合:
- コンピュータでファイルを探します。macOS での Unity DLL へのパスは次のとおりです。
Unity.app/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed - を右クリックします。
Unity.app - Show Package Contents (パッケージ内容の表示) を選択します。
- コンピュータで
-
-
フォルダーには、すべてのエディターコードとエンジンコードの
ManagedとUnityEditor.dllファサードアセンブリがそれぞれ格納されます。リファレンスを使用して、スクリプトで Editor または Engine API を使用できるようにします。個々のモジュールアセンブリはサポートされていないため、直接リファレンスを試みないでください。名前空間によっては、Unity プロジェクトからのコンパイル済みライブラリ (例えば、UnityEngine.dll) へのリファレンスも必要です。プロジェクトフォルダーのディレクトリUnityEngine.UI~\Library\ScriptAssemblies
-
-
DLL に Unity API コードが含まれていない場合、または Unity DLL をすでに使用可能にしている場合は、コンパイラーのドキュメントに従って .dll ファイルをコンパイルします。DLL のコンパイルに使用する正確なオプションは、使用するコンパイラーによって異なります。たとえば、Roslyn コンパイラーのコマンドラインの外観は、macOS では以下のようになります。
csc
csc /r:/Applications/Unity/Hub/Editor/<version-number>/Unity.app/Contents/Managed/UnityEngine.dll /target:library /out:MyManagedAssembly.dll /recurse:*.csこの例では、
- オプションを使用して、ビルドに含めるライブラリ (この場合は
/rライブラリ) へのパスを指定します。UnityEngine - オプションを使用して、必要なビルドのタイプを指定します。
/targetは DLL ビルドを示します。library - を使用してライブラリの名前を指定します。ここでは
/outです。MyManagedAssembly.dll - 含めるソースファイルの名前を追加します。メソッドを使用して、現在の作業ディレクトリと任意のサブフォルダに
/recurseで終わるすべてのファイルを追加します。結果の .dll ファイルは、ソースファイルと同じフォルダーに表示されます。.cs
マネージプラグインの使用
DLL をコンパイルしたら、他のアセットと同様に .dll ファイルを Unity プロジェクトにドラッグできます。その後、以下を実行できます。
- マネージプラグインを展開し、ライブラリ内の別のクラスを表示します。
- MonoBehaviour から派生したクラスをゲームオブジェクトにドラッグします。
- 他のスクリプトから直接 MonoBehaviour 以外のクラスを使用します。

An expanded DLL with the classes visible
Visual Studio での DLL の作成
このセクションでは、以下について説明します。
- 簡単な DLL サンプルをビルドして Visual Studio と統合する方法
- Unity で DLL のデバッグセッションを準備する方法。
プロジェクトの設定
-
Visual Studio を開き、新しいプロジェクトを作成します。
-
「ファイル」>「新規」>「プロジェクト」>「Visual C#」>「.Net Standard」>「クラスライブラリ (.NET Standard)」を選択します。
-
以下の情報を新しいライブラリに追加します。
- Name (名前): 名前空間(この例では、を名前として使用します)。
DLLTest - 場所: プロジェクトの親フォルダー。
- ソリューション名:プロジェクトのフォルダー。
- Name (名前): 名前空間(この例では、
-
スクリプトで Unity DLL を使用できるようにします。Visual Studio で、ソリューションエクスプローラーの References (参照) のコンテキストメニューを開き、**Add Reference (**リファレンスの追加)> Browse (参照)> Select File (ファイルの選択) を選択します。
-
UnityEngine フォルダーにある必要な .dll ファイルを選択します。
DLL のコーディング
- この例では、ソリューションブラウザーでデフォルトクラスの名前を に変更します。
MyUtilities - コードを以下のように置き換えます。
using System; using UnityEngine;名前空間 DLLTest { public class MyUtilities { public int c; public void AddValues(int a, int b) { c = a + b; } public static int GenerateRandom(int min, int max) { System.Random rand = new System.Random(); return rand.Next(min, max); } }}
- プロジェクトをビルドして、デバッグシンボルとともに DLL ファイルを生成します。
Unity での DLL のデバッグ
Unity で DLL のデバッグセッションを設定するには、以下を行います。
- Unity で新しいプロジェクトを作成し、ビルドした .dll ファイル (例えば ) を Assets フォルダーにコピーします。
<project folder>/bin/Debug/DLLTest.dll - Assets フォルダーに Test という Cスクリプトを作成します。
- そのコンテンツを、DLL で作成したクラスの新しいインスタンスを作成し、その機能を使用してコンソール ウィンドウに出力を表示するスクリプトに置き換えます。例えば、上のセクションから DLL のテストスクリプトを作成するには、以下のコードをコピーします。
using UnityEngine;using System.Collections;using DLLTest;public class Test :MonoBehaviour { void Start () { MyUtilities utils = new MyUtilities(); utils.AddValues(2, 3); print("2 + 3 = " + utils.c); } void Update () { print(MyUtilities.GenerateRandom(0, 100)); }}
- このスクリプトをシーンのゲームオブジェクトにアタッチ、設定、添付し、再生をクリックします。
Unity は DLL からのコード出力をコンソールウィンドウに表示します。
安全でない C# コードのコンパイル
Unsafe C# コードは、メモリに直接アクセスできるコードです。デフォルトでは有効になっていません。これは、コンパイラーがセキュリティリスクが生じないことを検証できないためです。
安全でないコードを使用して、以下を行うことができます。
- ポインターを使用してメモリにアクセスします。
- Raw メモリを割り当てます。
- ポインターを使用してメソッドをコールます。
安全でない C# コードのコンパイルのサポートを有効にするには、編集> > プレイヤー> その他の設定に移動し、Unsafe コード許可を有効にします。
プロジェクト設定
?
詳細については、安全でないコードのMicrosoftドキュメントを参照してください。