unity 插件
http://huangyaoshi.me/2015/07/25/plugins-system-in-unity/
Unity中的插件机制
JUL25TH,201512:01 PM
1. 介绍
Unity有两类插件: Managed plugins和Native plugin。
Managed plugins是托管式.NET代码，因为只有.NET代码，也就是说不能使用.NET库不支持的功能。
Native plugins是平台专门的原生代码库，可以用来访问操作系统调用或者第三方的库。
在Unity5之前，通过插件存放的目录来区分支持的目标平台；然而Unity5可以把插件放在任何目录，通过Plugin Inspector设置相关属性就可以了，但为了兼容以前的版本，Unity5也会支持插件存放的目录，进行默认的插件设置。
规则如下:
文件夹默认插件设置
Assets/**/Editor只兼容Editor
Assets/**/Editor/(x86 or x86_64 or x64)只兼容Editor，如果子文件夹存在，用于匹配目标CPU
Assets/Plugins/x86_64(or x64)x64兼容
Assets/Plugins/x86x86兼容
Assets/Plugins/Android/(x86 or armeabi or armeabi-v7a)只跟Android兼容，如果子文件夹存在，用于匹配目标CPU
Assets/Plugins/iOS只跟iOS兼容
2. 托管式插件
通常情况下，我们直接使用脚本实现相关功能，然后由Unity编译成目标可执行文件。但有时我们不能不在外部把脚本编译成DLL，然后放在Unity中使用。这个DLL就是这里所说的托管式插件，兼容.NET二进制。
2.1 创建一个DLL
如果制作的DLL依赖Unity本身的DLL(UnityEngine.dll和UnityEditor.dll),还需要使编译器能访问它们。 Mac系统，它们存放在/Applications/Unity/Unity.app/Contents/Frameworks/Managed/, Windows下，存放在C:\Program Files\Unity\Editor\Data\Managed
如果使用Mono C#编译器mcs编译，命令大体如下:
mcs -r:/Applications/Unity/Unity.app/Contents/Frameworks/Managed/UnityEngine.dll -target:library ClassesForDLL.cs
2.2 使用DLL
如同其它资源一样，直接拖放到Unity项目里。继承于MonoBehaviour的类可以直接拖到GameObject上，像普通脚本一样；非MonoBehaviour类可以在其它脚本中被直接使用。
2.3 为DLL设置调试功能
在MonoDevelop, 把生成的/bin/Debug/DLLTst.dll.mdb拷贝到Assets/Plugins文件夹下。在Visual Studio, 执行Program Files\Unity\Editor\Data\Mono\lib\mono\2.0\pdb2mdb.exe,按照提示传入\bin\Debug\DLLTest.pdb，然后把生成的mdb文件放到Assets/Plugins文件夹下。
接下来，确保Mono软调试器开启，Mac下是在MonoDevelop的MonoDevelop-Unity > Add-in Manager > Installed tab > Unity > select Mono Soft Debugger Support for Unity > Enable
然后就可以单步跟进DLL脚本里。
3. 原生插件
原生插件一般采用C,C++,Objective-C等等编写，Unity允许游戏代码来访问这些原生插件中的函数，允许Unity和一些中间件库或者已有的C/C++进行整合和。
3.1 实例
一个简单函数:
float FooPluginFunction () { return 5.0F; }
为了能再Unity中可以访问这简单函数，需要这么用:
using UnityEngine;
using System.Runtime.InteropServices;
class SomeScript : MonoBehaviour {
#if UNITY_IPHONE || UNITY_XBOX360
// On iOS and Xbox 360 plugins are statically linked into
// the executable, so we have to use __Internal as the
// library name.
[DllImport ("__Internal")]
#else
// Other platforms load plugins dynamically, so pass the name
// of the plugin's dynamic library.
[DllImport ("PluginName")]
#endif
private static extern float FooPluginFunction ();
void Awake () {
// Calls the FooPluginFunction inside the plugin
// And prints 5 to the console
print (FooPluginFunction ());
}
}
需要主要原生函数的name mangling问题，如果FooPluginFunction是用C++的代码，那么需要这样声明:
extern "C" {
float FooPluginFunction ();
}
4. Android平台
4.1 C/C++插件
做法跟上面的3.1类似，只是在编译库的时候需要依赖Android NDK
4.2 Java插件
可以把预编译的Android库项目扔到Assets/Plugins/Android文件夹。预编译的意思是所有.java文件必须已被编译成java存放在bin/或者libs文件夹下，当项目编译的时候这些文件夹下的AndroidManifest.xml会被自动合并到主manifest文件。
Unity期望Java插件使用JDK v1.6编译。如果使用v1.7，需要在命令参数中包含-source 1.6 -target 1.6
4.3 原生代码访问Java插件
一旦你生成了.jar文件，你需要把它拷贝到Assets/Plugins/Android文件夹下。然后通过JNI访问。
为了能再原生端访问java代码，你需要先访问Java虚拟机，代码如下:
jint JNI_OnLoad(JavaVM* vm, void* reserved) {
JNIEnv* jni_env = 0;
vm->AttachCurrentThread(&jni_env, 0);
return JNI_VERSION_1_6;
}
然后可以创建新的对象实例:
jobject createJavaObject(JNIEnv* jni_env) {
jclass cls_JavaClass = jni_env->FindClass("com/your/java/Class"); // find class definition
jmethodID mid_JavaClass = jni_env->GetMethodID (cls_JavaClass, "", "()V"); // find constructor method
jobject obj_JavaClass = jni_env->NewObject(cls_JavaClass, mid_JavaClass); // create object instance
return jni_env->NewGlobalRef(obj_JavaClass); // return object with a global reference
}
4.4 C#访问Java插件
Unity提供了API类AndroidJNIHelper和AndroidJNI简化JNI的访问，也提供了AndroidJavaObject、AndroidJavaClass和java.lang.Object、java.lang.class对应。
可以方便地:
调用方法
访问类成员变量
设置类成员变量
Call分成两类:
调用没有返回值(即返回void)的方法
调用有返回值的
例子如下:
//The comments describe what you would need to do if you were using raw JNI
AndroidJavaObject jo = new AndroidJavaObject("java.lang.String", "some_string");
// jni.FindClass("java.lang.String");
// jni.GetMethodID(classID, "", "(Ljava/lang/String;)V");
// jni.NewStringUTF("some_string");
// jni.NewObject(classID, methodID, javaString);
int hash = jo.Call("hashCode");
// jni.GetMethodID(classID, "hashCode", "()I");
// jni.CallIntMethod(objectID, methodID);
不用额外插件，通过UnityPlayer获得当前应用的cache目录:
AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
// jni.FindClass("com.unity3d.player.UnityPlayer");
AndroidJavaObject jo = jc.GetStatic("currentActivity");
// jni.GetStaticFieldID(classID, "Ljava/lang/Object;");
// jni.GetStaticObjectField(classID, fieldID);
// jni.FindClass("java.lang.Object");
Debug.Log(jo.Call("getCacheDir").Call("getCanonicalPath"));
// jni.GetMethodID(classID, "getCacheDir", "()Ljava/io/File;"); // or any baseclass thereof!
// jni.CallObjectMethod(objectID, methodID);
// jni.FindClass("java.io.File");
// jni.GetMethodID(classID, "getCanonicalPath", "()Ljava/lang/String;");
// jni.CallObjectMethod(objectID, methodID);
// jni.GetStringUTFChars(javaString);
上面代码只是举例说明，现在可以直接通过Application.temporaryCachePath和Application.persistentDataPath获得cache目录。
下面的例子演示使用UnitySendMessage从Java层把数据传递到C#:
using UnityEngine;
public class NewBehaviourScript : MonoBehaviour {
void Start () {
AndroidJNIHelper.debug = true;
using (AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) {
jc.CallStatic("UnitySendMessage", "Main Camera", "JavaMessage", "whoowhoo");
}
}
void JavaMessage(string message) {
Debug.Log("message from java: " + message);
}
}
4.5 扩展UnityPlayerActivity
可以创建一个新的Activity继承于UnityPlayerActivity(UnityPlayerActivity.java放在Mac的/Applications/Unity/Unity.app/Contents/PlaybackEngines/AndroidPlayer/com/unity3d/player或者Windows的C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\src\com\unity3d\player)。
首先，把classes.jar(Mac的/Applications/Unity/PlaybackEngines/AndroidPlayer/bin或者Windows下的C:\Program Files\Unity\Editor\Data)添加到classpath，用于编译新的Activity。生成.class打包成.jar文件，放到Assets/Plugins/Android文件夹；创建新的AndroidManifest.xml，指定启动的Activity,并把它放到Assets/Plugins/Android。
新的Acitivy，如下:
package com.company.product;
import com.unity3d.player.UnityPlayerActivity;
import android.os.Bundle;
import android.util.Log;
public class OverrideExample extends UnityPlayerActivity {
protected void onCreate(Bundle savedInstanceState) {
// call UnityPlayerActivity.onCreate()
super.onCreate(savedInstanceState);
// print debug message to logcat
Log.d("OverrideActivity", "onCreate called!");
}
public void onBackPressed()
{
// instead of calling UnityPlayerActivity.onBackPressed() we just ignore the back button event
// super.onBackPressed();
}
}
关联的AndroidManifest.xml如下:
android:label="@string/app_name"
android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
Gingerbread之后引入了UnityPlayerNativeActivity,相比于UnityPlayerActivity，它的输入延迟效果好。UnityPlayerNativeActivity的touch/motion事件都在原生代码中处理的，一般情况下Java视图不会接收到此类事件。Unity的重定向机制允许事件发往DalvikVM，如果使用这种机制，需要修改manifest:
android:label="@string/app_name"
android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
