本页面包含以下部分:
在开发 Unity Android 应用程序时,可使用插件来扩展标准的 UnityPlayerActivity
类(这是 Android 上的 Unity Player 的主 Java 类,类似于 Unity iOS 上的 AppController.mm)。应用程序可以覆盖 Android 操作系统和 Unity Android 应用程序之间的任何及所有基本交互。
要覆盖默认活动,请执行以下操作:
UnityPlayerActivity
派生的 Activity
(请参阅 Android 文档中有关活动 (Activity) 的部分);Activity
作为应用程序的入口点。为实现此目的,最简单的方法是从 Unity 导出项目,然后在 Android Studio 中对 UnityPlayerActivity
类进行必要的修改。
要用新 Activity
创建插件并将其添加到项目,必须执行以下步骤:
扩展 UnityPlayerActivity 文件。默认情况下,UnityPlayerActivity.java 文件位于:
Mac:
/Applications/Unity/Unity.app/Contents/PlaybackEngines/AndroidPlayer/src/com/unity3d/player
Windows:
C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\src\com\unity3d\player
要扩展 UnityPlayerActivity
文件,请找到 Unity 附带的 classes.jar 文件。该文件位于安装文件夹(Windows 上为 C:\Program Files\Unity\Editor\Data,Mac 上为 /Applications/Unity)的以下其中一个子文件夹中:
PlaybackEngines/AndroidPlayer/Variations/mono
il2cpp/Development
Release/Classes/
找到该文件,然后将 classes.jar 添加到 Unity 用于编译新 Activity
的类路径中。编译 Activity
源文件并将其打包到 JAR 或 AAR 包中,然后将其复制到项目文件夹。
创建一个新的 Android 清单以将新的 Activity
设置为应用程序的入口点,然后将 AndroidManifest.xml 文件放在项目的 Assets/Plugins/Android 文件夹中。
扩展 UnityPlayerActivity
时,可覆盖 String UnityPlayerActivity.updateUnityCommandLineArguments
(String cmdLine) 以将启动参数传递给 Unity。
UnityPlayerActivity
会在启动期间调用此方法。它接受当前的命令行参数(这些参数可为 null 或为空),并返回新的命令行参数字符串以传递给 Unity。
有关 Unity 命令行界面的一般概述,请参阅命令行参数。
下面的示例演示了如何使用该文件根据当前设备选择图形 API:
package com.company.product;
import com.unity3d.player.UnityPlayerActivity;
import android.os.Bundle;
import android.os.Build;
public class OverrideExample extends UnityPlayerActivity {
private boolean preferVulkan() {
// 在 Google Pixel 设备上使用 Vulkan
if (Build.MANUFACTURER.equals("Google") && Build.MODEL.startsWith("Pixel"))
return true;
else
return false;
}
private boolean preferES2() {
// 在运行 Android 5.1 或更早版本的设备上使用 OpenGL ES 2.0
if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.LOLLIPOP_MR1)
return true;
else
return false;
}
private String appendCommandLineArgument(String cmdLine, String arg) {
if (arg == null || arg.isEmpty())
return cmdLine;
else if (cmdLine == null || cmdLine.isEmpty())
return arg;
else
return cmdLine + " " + arg;
}
@Override protected String updateUnityCommandLineArguments(String cmdLine)
{
if (preferVulkan())
return appendCommandLineArgument(cmdLine, "-force-vulkan");
else if (preferES2())
return appendCommandLineArgument(cmdLine, "-force-gles20");
else
return cmdLine; // 让 Unity 根据 PlayerSettings 选择图形 API
}
@Override protected void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
}
}
以下是 UnityPlayerActivity
文件的示例:
OverrideExample.java:
package com.company.product;
import com.unity3d.player.UnityPlayerActivity;
import android.os.Bundle;
import android.util.Log;
public class OverrideExample extends UnityPlayerActivity {
protected void onCreate(Bundle savedInstanceState) {
// 调用 UnityPlayerActivity.onCreate()
super.onCreate(savedInstanceState);
// 将调试消息打印至 logcat
Log.d("OverrideActivity", "onCreate called!");
}
public void onBackPressed()
{
// 不调用 UnityPlayerActivity.onBackPressed(),而是直接忽略 Back 按钮事件
// super.onBackPressed();
}
}
相应的 AndroidManifest.xml 可能如下所示:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.company.product">
<application android:icon="@drawable/app_icon" android:label="@string/app_name">
<activity android:name="com.YourPackage.name.OverrideExample"
android:label="@string/app_name"
android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>