ユニバーサル Windows プラットフォーム: .NET スクリプトバックエンドのプラグイン

マネージドプラグイン

You cannot use Universal Windows Platform specific plugins in Unity Editor if you use Windows Runtime APIs (http://msdn.microsoft.com/en-us/library/windows/apps/br211377.aspx), so we changed a bit how Unity Editor handles them. If you intend to use the plugin only for Universal Windows Platform and not in Unity editor, you can skip making a placeholder. If you do this, you need to wrap the code which uses the plugin API with the following:

# if !UNITY_EDITOR
// プラグインコード
# endif

プレースホルダーが必要な場合は、2 種類のプラグインを作ります。

• Unity エディター用のプラグイン
• The other one for Universal Windows Platform

重要 Unity エディターのプレースホルダープラグインは、UnityEditor.dll を参照できません。そうでない場合は、以下のエラーが表示されます。

The Assembly UnityEditor is referenced by Plugin ('Assets/Plugins/Plugin.dll'). But the dll is not allowed to be included or could not be found.

Both of them must share the same name and have the same assembly version. For example, you should place Editor compatible plugin in Assets\Plugins\MyPlugin.dll, and Universal Windows Platform specific plugin in Assets\Plugins\WSA\MyPlugin.dll.

• Assets\Plugins\MyPlugin.dll に移動し、互換性のある唯一のプラットフォームにエディター を選択します

• Go to Assets\Plugins\WSA\MyPlugin.dll, select Universal Windows Platform as the only compatible platform, now go to Universal Windows Platform plugin settings

• Pick ‘Assets\Plugins\MyPlugin.dll’ in the placeholder field, this means that when building to Universal Windows Platform ‘Assets\Plugins\MyPlugin.dll’ will be used when compiling your scripts, but ‘Assets\Plugins\WSA\MyPlugin.dll’ will be copied to final folder instead of ‘Assets\Plugins\MyPlugin.dll’. This achieves two things - Unity Editor will successfully compile your scripts, but during the game you’ll be using API from Universal Windows Platform specific plugin.
  

Don’t process オプション

このオプションは Unity にアセンブリのパッチを行ってほしくない場合に使用します。通常このオプションはプラグインが多量の Windows Runtime API を使用していたり、Unity がパッチに失敗するような場合に適用します。

Universal Windows Platform Plugin Settings

プレースホルダーの例

例えば、次のような 2 つのアセンブリがあるとします。

• Plugins\WSA\MyPlugin.dll - Windows ランタイム API を内部で使用している .NET Core 用にコンパイルされたアセンブリ。

• Plugins\MyPlugin.dll - ダミーの関数を実装してまったく同一の public API を持つ .NET 3.5 用にコンパイルされたアセンブリ。

Plugins\WSA\MyPlugin.dll をクリックし、Placeholder から Plugins\MyPlugin.dll を選択します。

この方法は Plugins\MyPlugin.dll を参照するスクリプトを Unity がコンパイルする際に用いますが、Unity が最終的にプラグインをディレクトリーにコピーする際には Plugins\WSA\MyPlugin.dll が Plugins\MyPlugin.dll の代わりにコピーされます。

Unity がアセンブリにパッチしなかったらどうなりますか。

Unity はアゼンブリにシリアライズのコードを注入します。つまり、プラグインに MonoBehaviour のクラスがあるときに、Unity がそのパッチを行わないと、ランタイムにシリアライズのエラーが発生する場合があります。

Both of them must share the same name. For example, you should place an Editor compatible plugin at Assets\Plugins\MyPlugin.dll, and a Universal Windows Platform specific plugin at Assets\Plugins\WSA\MyPlugin.dll. When you’re working in Editor the Assets\Plugins\MyPlugin.dll will be used, and when you’re building to a Universal Windows Platform app the Assets\Plugins\WSA\MyPlugin.dll will copied over to the build.

• 2017–05–16 編集レビュー 無しにパブリッシュされたページ