unity开发之android与unity跨平台开发

前言
在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工程到我们的项目。
完成后项目目录如下:
unity开发之android与unity跨平台开发
文章图片
clipboard.png 接下来我们在android项目中编译运行该app,unity端为独立进程,见下图:
unity开发之android与unity跨平台开发
文章图片
06e4e1652b78f1b5a3e14676f3cf418.png 阅读该项目源码,发现android端和unity端的双端通信方式如下:
android端至unity端:
UnitySendMessage,这是方法我们至少需要传入两个参数,第一个参数为unity中的一个gameobject名称,第二个参数为这个gameobject身上捆绑的脚本中的一个方法,而第三参数事实上是这个对应方法上的参数。
例子:

mUnityPlayer.UnitySendMessage("Cube", "ChangeColor", "yellow");

unity端至android端:
通过反射机制,创建AndroidJavaClass 和AndroidJavaObject实例调用android端对应接口。
【unity开发之android与unity跨平台开发】例子:
#if UNITY_ANDROID try { AndroidJavaClass jc = new AndroidJavaClass("com.company.product.OverrideUnityActivity"); AndroidJavaObject overrideActivity = jc.GetStatic("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开发之android与unity跨平台开发
文章图片
1111.png 类图中unity核心类是UnityPlayerActivity,andriod app通过启动UnityPlayerActivity进入untiy世界。
该类源码文件位于unity程序安装目录下Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player
导出到android项目目录位于:

unity开发之android与unity跨平台开发
文章图片
20200422162459.png UnityPlayerActivity的核心成员变量是UnityPlayer, 该类源代码无法查看具体实现,但是通过查看UnityPlayer.class文件,我们大致可以了解:
  1. 该类继成自FrameLayout,
  2. 类成员变量主要包括:
  • Context mContext, context相关接口
  • SurfaceView类mGlView,用于展现UI
  • NetworkConnectivity类m_NetworkConnectivity ,监听网络变化,
  • AudioVolumeHandler 控制音量,
  • Camera2Wrapper m_Camera2Wrapper 相机相关控制
  • TelephonyManager m_TelephonyManager 网络相关控制
接着查看unity工程目录下的OverrideUnityActivity,从目录可以分析Android,iOS等多端平台相关内容都在Assets\Plugins下
unity开发之android与unity跨平台开发
文章图片
222.png 在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

    推荐阅读