プラグインのインポートと設定

マネージプラグイン または ネイティブプラグイン があれば、それを Unity にインポートして設定することができます。エディター内では、プラグインはスクリプトと同様にアセットとして扱われ、Inspector ウィンドウで設定することができます。

プラグイン設定を使用して、プラグインを実行する場所 (どのプラットフォーム、プラットフォームの設定、その条件など) を指定できます。

プラグインのインポート

プラグインをプロジェクトにインポートする最も簡単な方法は、プラグインをクリックして Assets フォルダーまたはそのサブフォルダーの 1 つにドラッグすることです。Unity は、特定のファイルやフォルダータイプをプラグインとして認識します。また、プラグインが意図するプラットフォームに合わせたデフォルトの設定を適用します。

対応するプラグインのファイルとフォルダーの種類

Unity では、以下の拡張子のファイルをプラグインとして扱います。

• a
• .aar
• .bc
• .c
• .cc
• .cpp
• .dll
• .def
• .dylib
• .h
• .jar
• .jslib
• .jspre
• .m
• .mm
• .prx
• .rpl
• .so
• .sprx
• .suprx
• .swift
• .winmd
• .xex
• .xib

また、Unity は特定のフォルダーをバンドルされたプラグインとして扱います。Unity はこれらのフォルダー内で追加のプラグインファイルを探しません。そのため、フォルダー内のすべてが 1 つのプラグインとみなされます。Unity は、以下の拡張子を持つフォルダーをバンドルされたプラグインとして扱います。

• .androidlib
• .bundle
• .framework
• .plugin

プラグインのデフォルト設定

Unity は、Assets フォルダー内のプラグインのパスがプラットフォーム固有のパターンに一致する場合、プラットフォーム固有のデフォルト設定をプラグインに自動的に適用します。パスがどのパターンにもマッチしない場合、Unity はエディタープラットフォームのデフォルト設定をプラグインに適用します。

以下の表は、Unity が認識するパスパターンを示しています。角かっこ内に表示されているパスの部分は任意です。パスにダブルドットが含まれている場合は、他のフォルダーを含むことができます。

プラグイン設定の変更

Unity では、プラグインは__マネージ__または__ネイティブ__のいずれかです。以下の表は、プラグインの種類ごとにどの設定が関連するかを示しています。

|設定 |マネージ|ネイティブ | |:—|:—|:—| |Select platforms for plugin|x|x |Platform settings|x|x| |Asset Labels|x|x| |アセットバンドル|x|x| |全般的な設定|x| | |制約を定義|x| | |Plugin load settings| |x|

Inspector でプラグインの設定を表示および変更するには、Project ウィンドウでプラグインファイルを選択します。

プラグインの共通設定

Select platform for plugin と Platform settings は、Unity がどのビルドにプラグインを加えるかを指定します。

以下の表では、共通の設定項目について説明しています。

ヒント: その他の一般的な設定については、アセットバンドル および エディターの検索 を参照してください。

マネージプラグインの設定

マネージプラグインでは、プロジェクトに加えたいサードパーティのライブラリやユーザーがコンパイルしたアセンブリが可能です。

General - Auto Reference

Auto Reference 設定は、プロジェクトのアセンブリ定義がプラグインファイルを参照する方法を制御します。Auto Reference を有効にすると、すべての定義済みのアセンブリとアセンブリ定義が自動的にプラグインファイルを参照します。

Auto Reference はデフォルトで有効になっています。

プラグインを参照できるスコープを制限するには、Auto Reference を無効にします。その場合、そのプラグインへのすべての参照を明示的に宣言する必要があります。以下のような場合には、これを行うとよいでしょう。

• スクリプトがプラグインを誤って使用することを防ぎたい。
• プラグインを反復していて、コンパイル時間を短縮したいと考えている場合。プラグインを明示的に宣言する場合、Unity はプロジェクト全体ではなく、依存するアセンブリのみを再コンパイルします。
• Asset Store のパッケージ で使用されているプラグインが、そのパッケージがインポートされているプロジェクトの他のコードと競合するのを防ぎたい場合。

Auto Reference のチェックを外すと、Unity がプロジェクト用に作成した事前定義されたアセンブリからプラグインを参照することができません。これらの事前定義されたアセンブリには、アセンブリ定義ファイルを使用して別のアセンブリに割り当てられていないプロジェクト内のすべてのスクリプトが含まれます。Auto Reference プロパティが無効になっているプラグインからクラス、関数、またはその他のリソースを参照するには、参照コードがアセンブリ定義ファイルで作成されたアセンブリに含まれている必要があります。例えば、プロジェクト内の一連のスクリプトがプラグインを使用している場合、それらのスクリプトのアセンブリ定義ファイルを作成し、定義ファイル内のプラグインへの明示的な参照を追加する必要があります。

複数のアセンブリがプラグインを使用できますが、すべてのアセンブリが依存関係を明示的に宣言する必要があります。Unity のアセンブリ定義についての詳細は、アセンブリの定義 を参照してください。

ノート: Auto Reference オプションは、ファイルがビルドに含まれるかには影響しません。プラグインのビルド設定を制御するには、Platform settings を使用します。

General - Validate Reference

Unity では、プラグインの参照がプロジェクト内で利用可能かどうかを確認することができます。この検証を行わないと、欠落した参照が使用されそうになると、ランタイムエラーが発生する可能性があります。

Validate References オプションを有効にして確認します。

• プラグインの参照が存在するかどうか。例えば、プラグインが Newtonsoft.Json.dll というプラグインを参照するときに、Newtonsoft.Json.dll が見つからない場合、Unity はエラーを表示します。
• 厳密な名前の参照をロードできるかどうか。厳密な名前の参照はバージョンと一致する必要があるため、これは重要です。例えば、“b.dll” のバージョン 2.0.0 を参照しているプラグインをコンパイルする場合、そのバージョンがプロジェクトに含まれていなければなりません。

厳密な名前の参照は確認したくないが、参照が存在することはチェックしたい場合。

1. Plugin Inspector で、Validate References を有効にします。
2. Project Settings > Player > Other Settings で Assembly Version Validation を無効にします。

制約を定義

プラグインを Unity のメモリにロードして参照する条件を指定することができます。これらの条件は、満たさなければならないシンボル、つまり定義済みか未定義か、を意味します。

制約は、C# の #if プリプロセッサーディレクティブのように動作しますが、スクリプトレベルではなくアセンブリレベルで動作します。制約については、Assembly Definition のプロパティ で詳しく説明しています。

Unity のビルトインの定義シンボルを使用したり、Project Settings > Player > Other Settings > Script Compilation > Scripting Define Symbols でシンボルを追加することもできます。追加するシンボルは、プラットフォームごとに異なります。そのため、関連するプラットフォームごとに定義する必要があります。ビルトインシンボルのリストなど、詳細は プラットフォーム依存コンパイル を参照してください。

ヒント: シンボルが未定義であることを指定するには、そのシンボルの前に否定の ! (エクスクラメーションマーク) を付けます。

以下の例では、Unity 2018.3 以降の非 IL2CPP スクリプティングランタイムでのみ、Unity がプラグインをロードして参照するようにします。そのためには 2 つの制約を定義し、両方とも満たす必要があります。

• ENABLE_IL2CPP は未定義
• UNITY_2018_3_OR_NEWER は定義済み

Plugin load settings - Load on startup

グラフィックスの初期化、スクリプト、アセットのロード、シーンなどに依存しないネイティブコードの実行を開始できます。これは、プレイヤーがネイティブプラグインをロードするデフォルトの方法とは異なり、通常、スクリプトによって実行されるプラグイン関数の 1 つが最初に呼び出されるまで待機します。

アプリケーションがスクリプトを実行する前にプラグインをロードするには以下を行います。

1. UnityPluginLoad をプラグインに実装します。低レベルのネイティブプラグインインターフェース を参照してください。
2. エディターで、Plugin load settings > Load on startup を選択します。

ヒント: プラグイン関数を呼び出す C# スクリプトの例については、ネイティブプラグイン を参照してください。

追加リソース

• [# マネージプラグイン](plug-ins-managed.html)
• ネイティブプラグイン
• デスクトップ向けのプラグイン
• ネイティブプラグインインターフェース