目錄
前言
背景
正文
環(huán)境
新建工程
Unity導(dǎo)出
Android接入
如何使用
作為Activity
總結(jié)
1.Android調(diào)用Unity
2.Unity調(diào)用Android
3.C/C++“中轉(zhuǎn)站”
參考資料
前言
背景
Unity 與 Android/IOS 交叉開(kāi)發(fā)主要有兩種方式,以 Android 為例,一是 Android 生成 jar 或者 aar 包,導(dǎo)入到 unity3d plugin/bin/ 目錄下;二是 Unity 導(dǎo)出 Android 工程,在 Android Studio 中作為庫(kù)繼續(xù)開(kāi)發(fā)。網(wǎng)上的教程幾乎全是第一種方式,而本文主要分析第二種方式。
這種方式可以在移動(dòng)端的 NativeApp 中以庫(kù)的形式集成已經(jīng)寫(xiě)好的 Unity 工程,利用 Unity 游戲引擎便捷的開(kāi)發(fā)手段進(jìn)行跨平臺(tái)開(kāi)發(fā)。
Unity官方文檔 Unity as a Library integration example to iOS and Android
以下以安卓平臺(tái)作為示例。
正文
環(huán)境
-
Android Studio 3.5.3
-
Unity version 2019.3.7f1
新建工程
Android Studio 新建項(xiàng)目:
Unity 新建項(xiàng)目:
最終工程結(jié)構(gòu)如下:
Unity導(dǎo)出
-
通過(guò) Unity 打開(kāi) UnityProject
-
選擇
File -> Build Settings -> Switch Android Platform -> Export Project
這時(shí)候選擇Export可能會(huì)提示JDK路徑配置出錯(cuò),沒(méi)關(guān)系我們到 Preference -> Externl Tools
設(shè)置路徑
現(xiàn)在就可以點(diǎn)擊 Export 了,路徑選擇可以自由選擇,這里建議按照官方來(lái)
Android接入
-
通過(guò) Android Studio 打開(kāi) NativeAndroidApp
-
選擇 setting.gradle 文件添加 unityLibrary module
include ':unityLibrary'
project(':unityLibrary').projectDir = new File('..\UnityProject\androidBuild\unityLibrary')
-
選擇 build.gradle(Module:app)添加 dependencies
dependencies {
implementation project(':unityLibrary')
implementation fileTree(dir: project(':unityLibrary').getProjectDir().toString() + ('\libs'), include: ['*.jar'])
// 自己項(xiàng)目的配置
}
-
選擇 build.gradle(Module:NativeAndroidApp)
allprojects {
repositories {
google()
jcenter()
// Add Code
flatDir {
dirs "${project(':unityLibrary').projectDir}/libs"
}
// End
}
}
-
選擇 NativeAndroidApp 的 strings.xml 添加
<resources>
<string name="app_name">NativeAndroidApp</string>
<string name="action_settings">Settings</string>
// Add Code
<string name="game_view_content_description">Game view</string>
// End
</resources>
-
點(diǎn)擊 AS 的 sync project,可以看到已經(jīng)多了一個(gè) module:
現(xiàn)在我們可以直接使用這個(gè) module 里的 JAVA class 了。
如何使用
作為Activity
現(xiàn)在我們的工程包含了兩個(gè) module ,一個(gè)是新建工程自帶的 app,一個(gè)是剛才導(dǎo)入的 unityLibrary。點(diǎn)開(kāi) unityLibrary 的目錄可以看到兩個(gè)主要的 class :
其中 UnityPlayerActivity 是最重要的 class ,我們可以通過(guò)這個(gè)類(lèi)在安卓 app 中顯示 Unity 的場(chǎng)景。
至于如何使用—— OverrideUnityActivity 則是對(duì) UnityPlayerActivity 用法的一個(gè)官方示例,里面的代碼也很簡(jiǎn)單。
import com.unity3d.player.UnityPlayerActivity;
public abstract class OverrideUnityActivity extends UnityPlayerActivity
{
public static OverrideUnityActivity instance = null;
abstract protected void showMainActivity(String setToColor);
@Override
protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
instance = this;
}
@Override
protected void onDestroy() {
super.onDestroy();
instance = null;
}
}
顯然官方希望我們?cè)诎沧績(jī)?nèi)用一個(gè) Activity 去顯示 Unity 渲染的場(chǎng)景,至于這個(gè) Activity ,直接繼承 UnityPlayerActivity 就基本完事了,非常簡(jiǎn)單。
新建一個(gè) Activity,這里命名為 SourceUnityActivity:
public class SourceUnityActivity extends UnityPlayerActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
}
}
現(xiàn)在只要繼承 UnityPlayerActivity 就行了。現(xiàn)在構(gòu)建 app,進(jìn)入 SourceUnityActivity 的時(shí)候就會(huì)顯示 Unity 的場(chǎng)景了。
總結(jié)
1.Android調(diào)用Unity
//向unity發(fā)消息
UnityPlayer.UnitySendMessage("Main Camera", //gameobject的名字
"ChangeColor", //調(diào)用方法的名字
""); //參數(shù)智能傳字符串,沒(méi)有參數(shù)則傳空字符串
2.Unity調(diào)用Android
//通過(guò)該API來(lái)實(shí)例化java代碼中對(duì)應(yīng)的類(lèi)
AndroidJavaObject jc = new AndroidJavaObject("com.xxx.xxx.UnityPlayer");
jo.Call("Test");//調(diào)用void Test()方法
jo.Call("Text1", msg);//調(diào)用string Test1(string str)方法
jo.Call("Text2", 1, 2);//調(diào)用int Test1(int x, int y)方法
3.C/C++“中轉(zhuǎn)站”
以上的傳參方式只能相互傳遞 string 字符串,少量數(shù)據(jù)傳遞時(shí)可以使用這種方式,如果是大量數(shù)據(jù)這樣就有點(diǎn)限制了。其實(shí)我們可以把C/C++的代碼做為一個(gè)中轉(zhuǎn)站,實(shí)現(xiàn)兩邊的數(shù)據(jù)引用與共享。只要在安卓工程加入 NDK 支持和 c++ 源碼,就可以在 Unity 端調(diào)用了。
其余進(jìn)階用法請(qǐng)自行摸索啦哈哈哈,包括Unity中內(nèi)置插件自控?cái)z像頭某些場(chǎng)景的額外編程但不只于此......
參考資料
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