寂寞烟雨 發表於 2023-8-30 14:13:00

Unity Android Studio 混合开发实践（Unity工程导入Android项目进行开发）

<h2 id="前言">前言</h2>
<p>最近接到一个任务是将一个unity开发的游戏接入到现有的Android项目里，然后在现有的App实现点击一个按钮打开游戏，并且在游戏内提供一个可以退出到App的按钮。</p>
<p>整体需求是很明确的，难点主要有两个：</p>
<ol>
<li>我们公司是做应用开发的，没有任何游戏开发的技能储备。</li>
<li>在游戏中需要和Native进行交互，比如我们的应用有账号体系，玩游戏时奖励金币需要和现有的用户体系合并。</li>
</ol>
<p>后面将会针对这两点注意解决。其中遇到的问题也将记录在下面。</p>
<h2 id="1-unity-开发基础">1. Unity 开发基础</h2>
<p>这个我先直接浏览了一下基础教程，我觉得这比看文档和视频教程快，可以快速了解Unity开发是什么，然后了解后面主要干什么。</p>
<p>大体来说，一个unity工程主要包含：</p>
<ol>
<li>C#脚本文件</li>
<li>Unity资源（Scenes 和图片字体资源文件、插件（Android、iOS等））</li>
</ol>
<p>在安卓里界面通常放在layout目录下，我们需要编辑一些xml文件，然后在java文件中对xml文件进行操作，这样UI就和代码联系在一起了。</p>
<p>而在Unity中你需要在Scenes中编写布局UI，然后将Scenes或者Scenes中的游戏对象和C#脚本文件绑定起来，之后就可以在C#脚本中编写逻辑了。</p>
<blockquote>
<p>Unity的基础可以自行搜索，网上的教程大同小异，可以快速过一些，不需要全部了解。等后面遇到问题了再来查阅也不迟。</p>
</blockquote>
<p>之后就是Unity客户端的安装了，这里就不多说了，网上类似的教程很多，选择一篇跟着做就可以。</p>
<h2 id="2-导出unity工程为一个android库">2. 导出Unity工程为一个Android库</h2>
<p>点击Unity客户端的<code>File-&gt;BuildSettings</code>可以打开导出和运行的配置界面：<br>
<img src="https://img2023.cnblogs.com/blog/848094/202308/848094-20230830102513893-554325093.png" alt="Unity的导出和配置界面" loading="lazy"></p>
<p>图中标记1：可以进入到配置界面，在那里可以设置导出的包名、版本、图标等信息。<br>
图中标记2：勾选Export才能出现标记3的导出选项。</p>
<p>导出后的文件结构如下图：<br>
<img src="https://img2023.cnblogs.com/blog/848094/202308/848094-20230830110837004-1722947556.png" alt="Unity导出为Android库" loading="lazy"></p>
<p>从图中可以看出Unity导出的是一个完整的Android工程文件，我们可以直接用AndroidStudio导入并打开。我这里需要在已有工程中导入<code>unityLibrary</code>模块即可。</p>
<p>值得注意的是，在<code>unityLibrary</code>中尽量对依赖项使用<code>compileOnly</code>，如果缺少后面再加，以免出现编译时出现大量重复类的错误。<br>
以下这些你可能在其他模块中配置过了</p>
<pre><code>dependencies {
    compileOnly fileTree(dir: 'libs', include: ['*.jar'])
    compileOnlyfiles('libs/androidx.versionedparcelable.versionedparcelable-1.1.1.aar')
    compileOnlyfiles('libs/androidx.swiperefreshlayout.swiperefreshlayout-1.0.0.aar')
    compileOnlyfiles('libs/androidx.documentfile.documentfile-1.0.0.aar')
    //....
}
</code></pre>
<p>比如<code>androidx.appcompat:appcompat:1.5.1</code>就包含很多依赖，其中大部分已经覆盖了Unity中的依赖，我们只需要引用一个就行。</p>
<blockquote>
<p>注意，如果你正在使用Git管理你的Android代码，那么对于刚导入的Unity模块来说，你需要忽略一些自动生成的文件，毕竟Unity这个模块还是很大的，甚至部分文件的单个大小就超过了100MB。</p>
</blockquote>
<h2 id="3-unity与android交互">3. Unity与Android交互</h2>
<p>这里我新建了一个<code>libunity</code>模块，然后将它加入到<code>App</code>依赖中，这样<code>libunity</code>就能和主模块就行交互，这里主要是获得用户信息和更新用户信息。</p>
<p>然后再将<code>libunity</code>导出为aar，将aar添加到Unity项目的<code>Plugins</code>中，这样在Unity项目中就能访问<code>libunity</code>中方法，由于<code>libunity</code>和<code>App</code>也是互通的，那么整个项目就通过<code>libunity</code>互相联系在一起了。</p>
<p>Unity调用Native方法主要分：</p>
<ol>
<li>Unity调用Native无参函数</li>
<li>Unity调用Native有参带返回值</li>
<li>Unity调用Native的参数是一个Callback对象</li>
</ol>
<p>为了方便描述，这里在<code>libunity</code>中创建一个<code>UnityConnector</code>的java类。</p>
<h4 id="1-unity调用native无参函数">1. Unity调用Native无参函数</h4>
<p>在UnityConnector中定义一个方法：</p>
<pre><code>void test(){}
</code></pre>
<p>那么在Unity中可以这样写：</p>
<pre><code>public static void PrintLog(string message)
{
   GetUnityConnector().Call("test");
}
</code></pre>
<h4 id="2-unity调用native有参带返回值">2. Unity调用Native有参带返回值</h4>
<p>在UnityConnector中定义一个方法：</p>
<pre><code>boolean printLog(@Nullable String message){}
</code></pre>
<p>那么在Unity中可以这样写：</p>
<pre><code>public static void PrintLog(string message)
{
   GetUnityConnector().Call&lt;bool&gt;("printLog",message);
}
</code></pre>
<h4 id="3-unity调用native的参数是一个callback对象">3. Unity调用Native的参数是一个Callback对象</h4>
<p>在UnityConnector中定义一个方法：</p>
<pre><code>void setNativeAdCallbackListener(NativeAdCallbackListener callbackListener){}
</code></pre>
<p>那么在Unity中可以这样写：</p>
<pre><code>public static void SetNativeAdCallbackListener(AndroidNativeAdCallbackListener adCallbackListener) {
      GetUnityConnector().Call("setNativeAdCallbackListener", adCallbackListener);
}
</code></pre>
<p>这里java中<code>NativeAdCallbackListener</code>是一个接口，在C#中还需要一个实现类。</p>
<pre><code>using System;
using UnityEngine;

//C#中访问Android中的
public class AndroidNativeAdCallbackListener : AndroidJavaProxy
{
    public AndroidNativeAdCallbackListener() : base("com.demo.unity.NativeAdCallbackListener")
    {
      Debug.Log("AndroidNativeAdCallbackListener init.");
    }
        //Android接口中的方法
    public void OnAdClosed(String platform) {
      Debug.Log("AndroidNativeAdCallbackListener OnAdClosed: "+ platform);
    }
}
</code></pre>
<p>实际调用：</p>
<pre><code>AndroidNativeManager.SetNativeAdCallbackListener(new AndroidNativeAdCallbackListener());
</code></pre>
<p>注：以上的 <code>GetUnityConnector()</code> 方法表示在C#中获取aar文件中的<code>UnityConnector</code>，具体代码如下：</p>
<pre><code>        //C#中获取UnityConnector
    public static AndroidJavaObject GetUnityConnector() {
      AndroidJavaClass unityConnector = new AndroidJavaClass("com.andcash.unity.UnityConnector");
      if (unityConnector == null)
      {
            Debug.Log("GetUnityConnector failed: unityConnector is null");
      }
      AndroidJavaObject instance = unityConnector.CallStatic&lt;AndroidJavaObject&gt;("getInstance");
      if (instance == null)
      {
            Debug.Log("GetUnityConnector failed: instance is null");
      }
      return instance;
    }
       
        //java中 UnityConnector
        private static UnityConnector instance;
        public static UnityConnector getInstance() {
      if (instance == null) {
            instance = new UnityConnector();
      }
      return instance;
    }
</code></pre>
<p>实际项目中的方法可能比较多，但是大体上离不开这几种。</p>
<blockquote>
<p>参考文章：<br>
https://www.cnblogs.com/zhxmdefj/p/13273560.html<br>
https://blog.csdn.net/u014361280/article/details/91888091<br>
https://blog.csdn.net/qq_33337811/article/details/87815573</p>
</blockquote>
<p>这里我没有使用Android调Unity，但是查阅文档可以知道Unity是支持的，它支持你向某个游戏对象发送消息。具体代码如下：</p>
<pre><code>    public void sendMessageToUnity(
            String gameObject,
            String method,
            String value
    ) {
      if (TextUtils.isEmpty(gameObject) || TextUtils.isEmpty(method)) {
            printLog("sendMessageToUnity failed: gameObject or method is empty.");
            return;
      }
      if (value == null) value = "";
      UnityPlayer.UnitySendMessage(gameObject, method, value);
    }
</code></pre>
<h2 id="4-错误处理">4. 错误处理</h2>
<p><strong>从Unity游戏中退出到Android页面时发生了崩溃？</strong></p>
<p>Unity退出游戏后会结束当前运行的进程，所以退出后由于进程被杀导致崩溃。<br>
解决方案：将 <code>com.unity3d.player.UnityPlayerActivity</code>设置为单独一个进程,在清单中添加 <code>android:process=":gameProcess"</code>，例如：</p>
<pre><code>&lt;activity
            android:name="com.unity3d.player.UnityPlayerActivity"
            android:configChanges="mcc|mnc|locale|touchscreen|keyboard|keyboardHidden|navigation|orientation|screenLayout|uiMode|screenSize|smallestScreenSize|fontScale|layoutDirection|density"
            android:exported="true"
            android:hardwareAccelerated="false"
            android:launchMode="singleTask"
            android:resizeableActivity="false"
            android:process=":gameProcess"
          //....
</code></pre>
<p>注意：新进程与默认进程之间的数据是默认分隔的，如果想通信的话需要使用进程之间通信。</p>
<p><strong>Unity游戏中的广告展示会黑屏？</strong></p>
<p>这是由于多进程导致，如果你还遇到崩溃那么应该是Android P之后Webview处理多进程导致的。<br>
解决方案：<br>
针对Webview可以在Applicantion中加入：</p>
<pre><code>if (Build.VERSION.SDK_INT &gt;= Build.VERSION_CODES.P) {
            if (packageName != Application.getProcessName()) {
                WebView.setDataDirectorySuffix(Application.getProcessName())
            }
      }
</code></pre>
<p>针对广告黑屏，例如我这里使用的是Applovin，那么我可以对它的广告页面添加<code>android:multiprocess="true"</code>,例如：</p>
<pre><code>&lt;activity
            android:name="com.applovin.adview.AppLovinFullscreenActivity"
            android:configChanges="fontScale|keyboard|keyboardHidden|locale|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
            android:exported="false"
            android:hardwareAccelerated="true"
            android:launchMode="singleTop"
            android:screenOrientation="behind"
            android:multiprocess="true"
            /&gt;
</code></pre>
<p>如果你使用的是Admob，也同理对Admob的具体广告页加入该参数。</p>
<p>该参数的意思是：调用进程uid和组件的uid相同（一个应用的不同进程uid是相同的）则Activity跑在调用进程里面，调用进程是谁，他就跑在那个进程里，换句话说 Activity 可以跑在不同进程里面。</p>
<p>对于<code>android:multiprocess="true"</code>的了解可以参考：https://blog.csdn.net/baidu_24392053/article/details/118275854</p>


</div>
<div id="MySignature" role="contentinfo">
    <!-- 版权声明 开始 -->
<div style="display: block; background: #F3F3F3; border: 1px dashed #888888; padding: 10px;" id="DidikeeSignature">
                        <div>作者：didikee</div>
                        <div>出处：http://www.cnblogs.com/didikee/</div>
                        <div>GitHub：https://github.com/didikee</div>
                        <div>本博客文章大多为原创，转载请请在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。 </div>
                </div>
<!-- 版权声明 结束 --><br><br>
来源：https://www.cnblogs.com/didikee/p/17667073.html
頁: [1]
查看完整版本: Unity Android Studio 混合开发实践（Unity工程导入Android项目进行开发）