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工程到我们的项目。

完成后项目目录如下：

clipboard.png

接下来我们在android项目中编译运行该app，unity端为独立进程，见下图：

06e4e1652b78f1b5a3e14676f3cf418.png

阅读该项目源码，发现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

完整阅读项目源码，生成如下类图：

1111.png

类图中unity核心类是UnityPlayerActivity，andriod app通过启动UnityPlayerActivity进入untiy世界。

该类源码文件位于unity程序安装目录下Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Source\com\unity3d\player
导出到android项目目录位于：

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下

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