1 前言

? ? ? ? 本文主要介紹 Unity 打包發(fā)布 Android apk 流程、基于?AndroidJavaObject（或?AndroidJavaClass）實(shí)現(xiàn) Unity 調(diào)用 Java 代碼、基于 UnityPlayer 實(shí)現(xiàn) Java 調(diào)用 Unity 代碼，官方介紹見(jiàn)→Android。

? ? ? ? Unity 項(xiàng)目 C#?中獲取平臺(tái)的代碼如下，需要引入 UnityEngine 命名空間。

RuntimePlatform platform = Application.platform; 

????????RuntimePlatform 是枚舉類型，主要平臺(tái)如下。

public enum RuntimePlatform {
    OSXEditor = 0, // editor on macOS.
    OSXPlayer = 1, // player on macOS.
    WindowsPlayer = 2, // player on Windows.  
    OSXWebPlayer = 3, // web player on macOS.
    ...
    WindowsWebPlayer = 5, // web player on Windows.
    WindowsEditor = 7, // editor on Windows.
    IPhonePlayer = 8, // player on the iPhone.
    Android = 11, // player on Android.
    ...
    WebGLPlayer = 17, // player on WebGL
    ...
    LinuxPlayer = 13, // player on Linux.
    LinuxEditor = 16, // editor on Linux.
    ...
}

2 Unity 發(fā)布 apk

2.1 安裝?Android Build Support

????????在 Unity Hub 中打開(kāi)添加模塊窗口，操作如下。

????????選擇 Android Build Support 安裝，如下（筆者這里已安裝過(guò)）。?

? ? ? ? ?創(chuàng)建一個(gè) Unity 項(xiàng)目，依次點(diǎn)擊【File→Build Settings→Android→Switch Platform】，配置如下。

????????依次點(diǎn)擊【Edit→Preferences→External Tools】打開(kāi) JDK、SDK、NDK、Gradle 配置頁(yè)面，勾選默認(rèn)配置，如下。

????????Unity Editor 不同版本默認(rèn)下載的 Gradle 版本如下，官方介紹見(jiàn)→Gradle for Android。

????????用戶也可以選擇已安裝的 JDK、SDK、NDK、Gradle 路徑，如下。

? ? ? ? 筆者的具體環(huán)境配置如下：

Unity Editor: 2021.3.11f1c2
JDK: 1.8.0_391
SDK Platforms: 29
SDK Build-Tools: 30.0.3
SDK Command-line Tools: 11.0
SDK Platform-Tools: 34.0.5
NDK: 21.3.6528147
Gradle: 6.1.1
Gradle Plugin: 4.0.1

2.2 配置密鑰

????????依次點(diǎn)擊【Edit→Project Settings→Player→Keystore Manager】（也可以從【File→Build Settings→Player Settings→Keystore Manager】中進(jìn)入），操作如下。

????????打開(kāi)?Keystore Manager 后， 依次點(diǎn)擊【Create New→Anywhere】，選擇一個(gè)目錄保存密鑰庫(kù)文件，筆者保存在項(xiàng)目目錄下面的【Keystore/user.keystore】中。

????????接著設(shè)置密碼和別名，其他選項(xiàng)不是必設(shè)項(xiàng)。

????????Add Key 后，會(huì)彈出 “是否將創(chuàng)建的密鑰庫(kù)作為項(xiàng)目的密鑰庫(kù)” 彈窗，點(diǎn)擊 yes 確認(rèn)。

? ? ? ? ?設(shè)置密鑰后，回到 Project Settings 頁(yè)面，顯示如下。

? ? ? ? 創(chuàng)建密鑰時(shí)，也可以通過(guò)以下命令創(chuàng)建。

keytool -genkey -keyalg RSA -alias key_name -keystore keystore_name -validity day_time
keytool -genkey -keyalg RSA -alias first -keystore user -validity 36500

2.3 打包 apk

????????依次點(diǎn)擊【File→Build Settings→Player Settings】，配置公司名、項(xiàng)目名、版本號(hào)等信息，如下。

? ? ? ? 在 Other Settings 中配置包名、Android SDK 的最小 API 版本、目標(biāo) API 版本等信息，如下。?

? ? ? ? 關(guān)閉 Player Settings，在 Build Settings 頁(yè)面點(diǎn)擊底部的 Build，構(gòu)建 apk。?

2.4 案例

? ? ? ? 新建一個(gè) Unity 項(xiàng)目，修改 Game 頁(yè)面的屏幕尺寸，如下。

? ? ? ? 搭建頁(yè)面如下。

????????給 Button 按鈕添加腳本，如下。

????????Test.cs

using UnityEngine;
using UnityEngine.UI;

public class Test : MonoBehaviour {
    private Button button;

    private void Start() {
        button = GetComponent<Button>();
        button.onClick.AddListener(OnClick);
    }

    private void OnClick() {
        Debug.Log("Test-OnClick");
    }
}

? ? ? ? 編譯 apk 后，打開(kāi)命令行窗口，輸入以下命令，將 apk 安裝到手機(jī)上。

adb instll -r -t -d Test.apk

? ? ? ? 運(yùn)行 apk 后，在命令行窗口中通過(guò)以下命令查看日志。

adb logcat | findstr "Test-OnClick"

? ? ? ? ?點(diǎn)擊 Button 按鈕，打印日志如下。

3 Unity 調(diào)?Android 的邏輯

3.1? Unity 項(xiàng)目中部署 Android 代碼

????????1）拷貝 Java 源碼到 Unity 項(xiàng)目

????????可以將 Android 項(xiàng)目中 Java 代碼拷貝到 Unity 項(xiàng)目中?Assets 子目錄下，如下，接著就可以通過(guò)?AndroidJavaClass 或 AndroidJavaObject 訪問(wèn) Java 代碼了。

? ? ? ? 2）打包 Jar 到 Unity 項(xiàng)目

????????可以將 Android 項(xiàng)目打包為 Jar，再將 Jar 拷貝到 Unity 項(xiàng)目中?Assets 子目錄下，接著就可以通過(guò)?AndroidJavaClass 或 AndroidJavaObject 訪問(wèn) Java 代碼了。

????????修改 Android 項(xiàng)目中 Module 的 build.gradle 文件，如下，主要將 id 由 'com.android.application'?修改為 'com.android.library'，刪除 android { } 模塊中的 defaultConfig、buildTypes、compileOptions 等子模塊。

????????build.gradle

apply plugin: 'com.android.library'

android {
    compileSdkVersion 29
    buildToolsVersion '30.0.3'

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.8.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

????????修改 build.gradle 文件后，需要點(diǎn)擊右上角的 Sync Now 同步，接著按以下步驟編譯項(xiàng)目。

????????編譯結(jié)束后，在 Module 的【build\intermediates\aar_main_jar\debug】目錄下生成打包的 classes.jar。

? ? ? ? 預(yù)覽 classes.jar 文件如下。

3.2 AndroidJavaObject 和 AndroidJavaClass

? ? ? ? AndroidJavaObject 和?AndroidJavaClass 是 Unity 提供的調(diào)用 Java 代碼的 2 個(gè)類，AndroidJavaClass 繼承 AndroidJavaObject，它們只有構(gòu)造方法有一點(diǎn)差異，沒(méi)有其他的差異，因此，本節(jié)只介紹?AndroidJavaObject。

? ? ? ? 1）Set 和 Get 屬性

? ? ? ? JavaTest.java

package com.zhyan8.test;

public class JavaTest {
    public static int intVal = 0;
    private String strVal = "abc";
}

? ? ? ? 說(shuō)明：對(duì)于 JavaTest 的 private 屬性，AndroidJavaObject?也可以訪問(wèn)到。?

? ? ? ? UnityTest.cs

using UnityEngine;

public class UnityTest : MonoBehaviour {
    private void Start() {
        AndroidJavaObject javaObject = new AndroidJavaObject("com.zhyan8.test.JavaTest");
        // 靜態(tài)屬性Set/Get
        javaObject.SetStatic<int>("intVal", 123);
        int intVal = javaObject.GetStatic<int>("intVal");
        Debug.Log("UnityTest, intVal=" + intVal); // 打印: UnityTest, intVal=123
        // 非靜態(tài)屬性Set/Get
        javaObject.Set<string>("strVal", "xyz");
        string strVal = javaObject.Get<string>("strVal");
        Debug.Log("UnityTest, strVal=" + strVal); // 打印: UnityTest, strVal=xyz
    }
}

? ? ? ? 2）調(diào)用方法

? ? ? ? JavaTest.java

package com.zhyan8.test;

import android.util.Log;

public class JavaTest {
    public static void fun1() {
        Log.d("JavaTest", "fun1"); // 打印: JavaTest: fun1
    }

    private int fun2() {
        Log.d("JavaTest", "fun2"); // 打印: JavaTest: fun2
        return 123;
    }

    public String fun3(int value) {
        Log.d("JavaTest", "fun3, value=" + value); // 打印: JavaTest: fun3, value=235
        return "Call fun3";
    }

    public String fun4(String value1, int value2) {
        Log.d("JavaTest", "fun4, value1=" + value1 + ", value2=" + value2); // 打印: JavaTest: fun4, value1=abc, value2=123
        return value1 + value2;
    }
}

????????說(shuō)明：對(duì)于 JavaTest 的 private 方法，AndroidJavaObject?也可以訪問(wèn)到。??

????????UnityTest.cs

using UnityEngine;

public class UnityTest : MonoBehaviour {
    private void Start() {
        AndroidJavaObject javaObject = new AndroidJavaObject("com.zhyan8.test.JavaTest");
        // 靜態(tài)方法
        javaObject.CallStatic("fun1");
        // 非靜態(tài)無(wú)參方法
        int val2 = javaObject.Call<int>("fun2");
        Debug.Log("UnityTest, val2=" + val2); // 打印: UnityTest, val2=123
        // 非靜單參方法
        string val3 = javaObject.Call<string>("fun3", 235);
        Debug.Log("UnityTest, val3=" + val3); // 打印: UnityTest, val3=Call fun3
        // 非靜雙參方法
        string val4 = javaObject.Call<string>("fun4", "abc", 123);
        Debug.Log("UnityTest, val4=" + val4); // 打印: UnityTest, val4=abc123
    }
}

? ? ? ? 運(yùn)行程序后，打印日志如下。

3.3 Unity 調(diào)用 Android 的 Toast

????????UnityTest.cs

using UnityEngine;
using UnityEngine.UI;

public class UnityTest : MonoBehaviour {
    private void Start() {
        GetComponent<Button>().onClick.AddListener(() => {
            Toast("Clicked", 1);
        });
    }

    // 調(diào)用Android的代碼: Toast.makeText(context, msg, durationFlag).show();
    private void Toast(string msg, int durationFlag) { // durationFlag: Toast.LENGTH_SHORT=0, Toast.LENGTH_LONG=1
        AndroidJavaClass toastClass = new AndroidJavaClass("android.widget.Toast");
        AndroidJavaClass unityPlayerClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
        AndroidJavaObject currentActivity = unityPlayerClass.GetStatic<AndroidJavaObject>("currentActivity");
        AndroidJavaObject toast = toastClass.CallStatic<AndroidJavaObject>("makeText", currentActivity, msg, durationFlag);
        toast.Call("show");
    }
}

????????UnityPlayer 是 Unity 引擎提供的 Java 類，在 Unity Editor 目錄下的【Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jar】 中。

? ? ? ? 運(yùn)行效果如下。

4 Android 調(diào) Unity 的邏輯

4.1 Unity 打包為 Android 項(xiàng)目

? ? ? ? 在 Build Settings 頁(yè)面勾選 Export Project 后，點(diǎn)擊 Export 按鈕，如下。

? ? ? ? 構(gòu)建成功后，Unity 項(xiàng)目將會(huì)被打包成一個(gè) Android 項(xiàng)目，我們可以使用 Android Studio 打開(kāi)生成的 Android 項(xiàng)目，如下。

? ? ? ? 其中，UnityPlayerActivity 是啟動(dòng)的 Main Activity，unity-classes.jar 是 Unity Editor 中的 Jar 包，位置見(jiàn)【Unity Hub\Unity\Editor\2021.3.11f1c2\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jar】，我們常用的?UnityPlayer 類就在該 Jar 文件中。

? ? ? ? 如果用戶想將 Android 項(xiàng)目打包到 Unity 項(xiàng)目中，但是 Android 項(xiàng)目中又要引用 Unity 的接口，用戶可以將 Unity Editor 中的 classes.jar 拷貝到 Android 項(xiàng)目中，如下。

? ? ? ? 右鍵 classes.jar，在彈出菜單中選擇 Add As Library。

4.2 UnityPlayer

????????UnityPlayer?繼承 FrameLayout，主要用于 Java 調(diào)用 Unity 代碼，其主要屬性和方法如下。

// 在UnityPlayer的構(gòu)造方法中初始化, currentActivity = this.mActivity
public static Activity currentActivity = null;

// java調(diào)用Unity中的方法, gameObject: 游戲?qū)ο竺? method: 游戲?qū)ο笊蠏燧d腳本中的方法名, params: 方法參數(shù)
public static void UnitySendMessage(String gameObject, String method, String params)

????????說(shuō)明：UnitySendMessage 可以調(diào)用 private 方法，只能調(diào)用無(wú)參和單參數(shù)方法，不能調(diào)用 static 方法，無(wú)法獲取方法返回值。

4.3 案例

? ? ? ? UseUnity.cs

using UnityEngine;

public class UseUnity : MonoBehaviour {

    private void Start() {
        AndroidJavaObject javaObject = new AndroidJavaObject("com.zhyan8.test.JavaTest");
        javaObject.Call("start");
    }

    public void Fun1() {
        Debug.Log("UseUnity-Fun1"); // 打印: UseUnity-Fun1
    }

    private void Fun2(string value) {
        Debug.Log("UseUnity-Fun2, value=" + value); // 打印: UseUnity-Fun2, value=xyz
    }
}

????????說(shuō)明：UseUnity?腳本組件掛在?TestObj 對(duì)象上。

????????JavaTest.java

package com.zhyan8.test;

import android.util.Log;

import com.unity3d.player.UnityPlayer;

public class JavaTest {

    public void start() {
        fun1();
        fun2();
    }

    private void fun1() {
        Log.d("JavaTest", "fun1"); // 打印: JavaTest: fun1
        UnityPlayer.UnitySendMessage("TestObj", "Fun1", "");
    }

    private void fun2() {
        Log.d("JavaTest", "fun2"); // 打印: JavaTest: fun2
        UnityPlayer.UnitySendMessage("TestObj", "Fun2", "xyz");
    }
}

? ? ? ? 打印日志如下：

文章來(lái)源地址http://www.zghlxwxcb.cn/news/detail-732521.html

到了這里，關(guān)于【Unity3D】Unity與Android交互的文章就介紹完了。如果您還想了解更多內(nèi)容，請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！