为 Android 构建插件

若想要为 Android 构建插件, 您首先应该获得 Android NDK,并熟悉包括构建共享库在内的所有步骤。

如果使用 C++ (.cpp) 实现插件,则必须确保所创建的功能使用 C linkage 方式进行声明,以避免出现名称重整问题。

[JavaScript] 纯文本查看 复制代码
?
1
2
3
extern \"C\" {
  float FooPluginFunction ();
}

并且添加相应的 AndroidManifest.xml,如下所示:

    <?xml version=”1.0″ encoding=”utf-8″?>
<manifest xmlns:android=”http://schemas.android.com/apk/res/android” package=”com.company.product”>
<application android:icon=”@drawable/app_icon” android:label=”@string/app_name”>
<activity android:name=”.OverrideExample”
android:label=”@string/app_name”
android:configChanges=”fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen”>
<intent-filter>
<action android:name=”android.intent.action.MAIN” />
<category android:name=”android.intent.category.LAUNCHER” />
</intent-filter>
</activity>
</application>
</manifest>

UnityPlayerNativeActivity

您也可以创建自己的 UnityPlayerNativeActivity 子类。这与 UnityPlayerActivity 子类化具有相同的效果,但改善了输入延迟。但还是要注意,NativeActivity 在 Gingerbread 引入,但在老设备并不能运行。因为 touch/motion 事件在本地代码中处理,Java 视图通常不会看到这些事件。然而,Unity 有一个的转发机制,允许事件传递到 DalvikVM。您必须设置清单文件以开启此功能,如下所示:

    <?xml version=”1.0″ encoding=”utf-8″?>
<manifest xmlns:android=”http://schemas.android.com/apk/res/android” package=”com.company.product”>
<application android:icon=”@drawable/app_icon” android:label=”@string/app_name”>
<activity android:name=”.OverrideExampleNative”
android:label=”@string/app_name”
android:configChanges=”fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen”>
<meta-data android:name=”android.app.lib_name” android:value=”unity” />
<meta-data android:name=”unityplayer.ForwardNativeEventsToDalvik” android:value=”true” />
<intent-filter>
<action android:name=”android.intent.action.MAIN” />
<category android:name=”android.intent.category.LAUNCHER” />
</intent-filter>
</activity>
</application>
</manifest>

注意,”.OverrideExampleNative” 属于活动元素以及两种其他的元数据元素。第一个元数据是使用 Unity 库 libunity.so。第二个元数据允许事件传递至 UnityPlayerNativeActivity 的自定义子类。