前言
在android开发中,我们可能希望在现有的android项目中添加对unity的支持,以实现app拥有AR/VR,3D交互,2D游戏等unity的功能。以下将介绍如何实现该具体过程。
正文
本文基于Unity-Technologies/uaal-example项目分析
https://github.com/Unity-Technologies/uaal-example/blob/master/docs/android.md
该文档介绍利用unity的Build Settings功能下的Export Project,将一个unity project 导出为Android project, 该Android project目录下包括了unityLibrary module ,我们只需要按照Android项目如何添加一个现有module项目到当前工程目录的方式,最终实现整合unity工程到我们的项目。
完成后项目目录如下:
接下来我们在android项目中编译运行该app,unity端为独立进程,见下图:
阅读该项目源码,发现android端和unity端的双端通信方式如下:
android端至unity端:
UnitySendMessage,这是方法我们至少需要传入两个参数,第一个参数为unity中的一个gameobject名称,第二个参数为这个gameobject身上捆绑的脚本中的一个方法,而第三参数事实上是这个对应方法上的参数。
例子:
mUnityPlayer.UnitySendMessage("Cube", "ChangeColor", "yellow");
unity端至android端:
通过反射机制,创建AndroidJavaClass 和AndroidJavaObject实例调用android端对应接口。
例子:
#if UNITY_ANDROID
try
{
AndroidJavaClass jc = new AndroidJavaClass("com.company.product.OverrideUnityActivity");
AndroidJavaObject overrideActivity = jc.GetStatic<AndroidJavaObject>("instance");
overrideActivity.Call("showMainActivity", lastStringColor);
} catch(Exception e)
{
appendToText("Exception during showHostMainWindow");
appendToText(e.Message);
}
#elif UNITY_IOS || UNITY_TVOS
NativeAPI.showHostMainWindow(lastStringColor);
#endif
完整阅读项目源码,生成如下类图:
类图中unity核心类是UnityPlayerActivity,andriod app通过启动UnityPlayerActivity进入untiy世界。
该类源码文件位于unity程序安装目录下Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player
导出到android项目目录位于:
UnityPlayerActivity的核心成员变量是UnityPlayer, 该类源代码无法查看具体实现,但是通过查看UnityPlayer.class文件,我们大致可以了解:
该类继成自FrameLayout,
类成员变量主要包括:
Context mContext, context相关接口
SurfaceView类mGlView,用于展现UI
NetworkConnectivity类m_NetworkConnectivity ,监听网络变化,
AudioVolumeHandler 控制音量,
Camera2Wrapper m_Camera2Wrapper 相机相关控制
TelephonyManager m_TelephonyManager 网络相关控制
接着查看unity工程目录下的OverrideUnityActivity,从目录可以分析Android,iOS等多端平台相关内容都在Assets\Plugins下
在Android目录下添加一个android aar文件,重新Export Project到Android 工程下,查看build.grandle(Module:unityLibrary), 已自动添加了该aar文件的依赖。
总结:
通过学习uaal-example源码,我们知道了
- Android进入Unity世界的桥梁UnityPlayerActivity和UnityPlayer,
- android和unity的通信接口 UnitySendMessage, 反射方式创建AndroidJavaClass和AndroidJavaObject
- Android和unity多工程跨平台项目开发方式Export Project,iOS端与此类似,本文不再赘述。
参考:
https://docs.unity3d.com/Manual/UnityasaLibrary-Android.html
https://github.com/Unity-Technologies/uaal-example/blob/master/docs/android.md