Android/iOS内嵌Unity开发示例

目次

前言
背景
正文
环境
新建工程
Unity导出
Android接入
如何利用
作为Activity
总结
1.Android调用Unity
2.Unity调用Android
3.C/C++“中转站”
参考资料

---

前言

背景

Unity 与 Android/iOS 交叉开发重要有两种方式，以 Android 为例，一是 Android 生成 jar 或者 aar 包，导入到 unity3d plugin/bin/ 目次下；二是 Unity 导出 Android 工程，在 Android Studio 中作为库继承开发。网上的教程几乎全是第一种方式，而本文重要分析第二种方式。
这种方式可以在移动端的 NativeApp 中以库的情势集成已经写好的 Unity 工程，利用 Unity 游戏引擎便捷的开发本领举行跨平台开发。
Unity官方文档 Unity as a Library integration example to iOS and Android
以下以安卓平台作为示例。

---

正文

环境

• Android Studio 3.5.3
  
• Unity version 2019.3.7f1
  

---

新建工程

Android Studio 新建项目：

Unity 新建项目：

终极工程布局如下：

---

Unity导出

• 通过 Unity 打开 UnityProject
  
• 选择 File -> Build Settings -> Switch Android Platform -> Export Project
  

这时候选择Export大概会提示JDK路径配置出错，没关系我们到 Preference -> Externl Tools 设置路径

现在就可以点击 Export 了，路径选择可以自由选择，这里建议按照官方来

---

Android接入

• 通过 Android Studio 打开 NativeAndroidApp
  
• 选择 setting.gradle 文件添加 unityLibrary module
  

1. include ':unityLibrary'
2. project(':unityLibrary').projectDir = new File('..\\UnityProject\\androidBuild\\unityLibrary')

复制代码

• 选择 build.gradle(Module：app)添加 dependencies
  

1. dependencies {
2.     implementation project(':unityLibrary')
3.     implementation fileTree(dir: project(':unityLibrary').getProjectDir().toString() + ('\\libs'), include: ['*.jar'])
4.     // 自己项目的配置
5. }

复制代码

• 选择 build.gradle(Module：NativeAndroidApp)
  

1. allprojects {
2.     repositories {
3.         google()
4.         jcenter()
6.         // Add Code
7.         flatDir {
8.             dirs "${project(':unityLibrary').projectDir}/libs"
9.         }
10.         // End
11.     }
12. }

复制代码

• 选择 NativeAndroidApp 的 strings.xml 添加
  

1. <resources>
2.     <string name="app_name">NativeAndroidApp</string>
3.     <string name="action_settings">Settings</string>
4.     // Add Code
5.     <string name="game_view_content_description">Game view</string>
6.     // End
7. </resources>

复制代码

• 点击 AS 的 sync project，可以看到已经多了一个 module：
  

现在我们可以直接利用这个 module 里的 java class 了。

---

如何利用

作为Activity

现在我们的工程包含了两个 module ，一个是新建工程自带的 app，一个是刚才导入的 unityLibrary。点开 unityLibrary 的目次可以看到两个重要的 class ：

其中 UnityPlayerActivity 是最告急的 class ，我们可以通过这个类在安卓 app 中显示 Unity 的场景。
至于如何利用—— OverrideUnityActivity 则是对 UnityPlayerActivity 用法的一个官方示例，里面的代码也很简单。

1. import com.unity3d.player.UnityPlayerActivity;
3. public abstract class OverrideUnityActivity extends UnityPlayerActivity
4. {
5.     public static OverrideUnityActivity instance = null;
7.     abstract protected void showMainActivity(String setToColor);
9.     @Override
10.     protected void onCreate(Bundle savedInstanceState)
11.     {
12.         super.onCreate(savedInstanceState);
13.         instance = this;
14.     }
16.     @Override
17.     protected void onDestroy() {
18.         super.onDestroy();
19.         instance = null;
20.     }
21. }

复制代码

显然官方希望我们在安卓内用一个 Activity 去显示 Unity 渲染的场景，至于这个 Activity ，直接继承 UnityPlayerActivity 就基本完事了，非常简单。
新建一个 Activity，这里命名为 SourceUnityActivity：

1. public class SourceUnityActivity extends UnityPlayerActivity {
2.     @Override
3.     protected void onCreate(Bundle savedInstanceState) {
4.         super.onCreate(savedInstanceState);
5.     }
6. }

复制代码

  现在只要继承 UnityPlayerActivity 就行了。现在构建 app，进入 SourceUnityActivity 的时候就会显示 Unity 的场景了。
  

---

总结

1.Android调用Unity

1. //向unity发消息
2. UnityPlayer.UnitySendMessage("Main Camera", //gameobject的名字
3.                              "ChangeColor", //调用方法的名字
4.                              "");                        //参数智能传字符串，没有参数则传空字符串

复制代码

2.Unity调用Android

1. //通过该API来实例化java代码中对应的类
2. AndroidJavaObject jc = new AndroidJavaObject("com.xxx.xxx.UnityPlayer");
3. jo.Call("Test");//调用void Test()方法
4. jo.Call("Text1", msg);//调用string Test1(string str)方法
5. jo.Call("Text2", 1, 2);//调用int Test1(int x, int y)方法

复制代码

3.C/C++“中转站”

以上的传参方式只能相互传递 string 字符串，少量数据传递时可以利用这种方式，如果是大量数据如许就有点限制了。其实我们可以把C/C++的代码做为一个中转站，实现双方的数据引用与共享。只要在安卓工程加入 NDK 支持和 c++ 源码，就可以在 Unity 端调用了。

其余进阶用法请自行探索啦哈哈哈，包罗Unity中内置插件自控摄像头某些场景的额外编程但不只于此......

---

参考资料

Unity - Manual: Android Library Projects and Android Archive plug-ins
Unity - Manual: Extend the default Unity activity
Unity - Manual: Native plug-ins for Android
Integration Unity as a library in native Android app - Unity Forum
unity3d - Display Unity Scene as Sub View in android studio - Stack Overflow

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。