Unity与Android原生交互：JNI接口调用实战指南

1. 为什么Unity需要调用Android接口作为一名同时使用Unity和Android开发的程序员我经常遇到需要在Unity项目中调用原生Android功能的需求。比如接入第三方SDK微信登录、QQ登录、调用硬件传感器、使用系统级API等场景。Unity虽然强大但某些功能仍需借助原生平台实现。这里有个常见的误区很多开发者认为Unity调用Android接口就是简单的发个消息。实际上这涉及到两个完全不同的运行时环境之间的通信。Unity运行在Dalvik/ART虚拟机之上而Unity使用自己的Mono或IL2CPP运行时两者需要通过JNIJava Native Interface这座桥梁来对话。2. 环境准备与基础配置2.1 创建Android Library模块首先在你的Android Studio项目中创建一个新的Android Library模块File → New → New Module → Android Library命名为unity-android-bridge名称可自定义确保minSdkVersion与Unity项目设置一致关键点不要直接在主app模块中编写接口代码使用独立模块更利于维护和复用。我曾在项目中因混用模块导致类冲突调试了整整两天。2.2 修改build.gradle配置在library模块的build.gradle中添加必要依赖dependencies { implementation fileTree(dir: libs, include: [*.jar]) implementation androidx.appcompat:appcompat:1.3.0 // 添加Unity classes依赖关键 compileOnly files(path/to/Unity/classes.jar) }提示Unity安装目录下的classes.jar路径通常为 Windows:C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Classes\classes.jarMac:/Applications/Unity/Hub/Editor/[version]/PlaybackEngines/AndroidPlayer/Variations/mono/Release/Classes/classes.jar2.3 处理UnityPlayerActivity创建自定义Activity继承UnityPlayerActivitypackage com.yourcompany.unitybridge; import com.unity3d.player.UnityPlayerActivity; import android.os.Bundle; import android.util.Log; public class CustomUnityActivity extends UnityPlayerActivity { Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 初始化代码... } // 示例供Unity调用的方法 public String GetDeviceInfo() { return Manufacturer: android.os.Build.MANUFACTURER \nModel: android.os.Build.MODEL; } }3. JNI交互实现详解3.1 Unity调用Java方法在Unity C#脚本中调用Android方法的基本模式// 获取当前Activity的Java对象 AndroidJavaClass unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer); AndroidJavaObject currentActivity unityPlayer.GetStaticAndroidJavaObject(currentActivity); // 调用Java方法 string deviceInfo currentActivity.Callstring(GetDeviceInfo); Debug.Log(Android返回: deviceInfo);常见问题排查方法名大小写错误Java是大小写敏感的未在主线程调用Android要求UI操作必须在主线程参数类型不匹配如C#的int对应Java的Integer3.2 Java回调Unity在Android端回调Unity需要使用UnitySendMessage// 在Android代码中 UnityPlayer.UnitySendMessage(GameObjectName, MethodName, message);对应的Unity C#脚本public class AndroidCallbackReceiver : MonoBehaviour { // 方法必须为public public void OnAndroidMessage(string message) { Debug.Log(收到Android回调: message); } }重要限制UnitySendMessage只能传递一个string参数且目标GameObject必须存在于场景中。我在实际项目中更推荐使用AndroidJavaProxy建立双向通信通道。3.3 处理复杂数据类型当需要传递JSON等复杂数据时Java端public String GetUserData() { JSONObject json new JSONObject(); try { json.put(name, 张三); json.put(score, 100); } catch (JSONException e) { e.printStackTrace(); } return json.toString(); }Unity端解析string json currentActivity.Callstring(GetUserData); UserData data JsonUtility.FromJsonUserData(json); [Serializable] public class UserData { public string name; public int score; }4. 实战集成QQ登录功能4.1 配置QQ开放平台在QQ开放平台创建应用获取App ID下载官方SDK将jar包放入library模块的libs目录在AndroidManifest.xml中添加必要权限和Activity声明4.2 实现登录接口Java端代码public void QQLogin(final String unityCallbackObj) { mTencent Tencent.createInstance(你的AppID, this); if (!mTencent.isSessionValid()) { mTencent.login(this, all, new IUiListener() { Override public void onComplete(Object o) { // 登录成功回调Unity UnityPlayer.UnitySendMessage(unityCallbackObj, OnQQLoginSuccess, o.toString()); } // 其他回调方法... }); } }Unity端调用public void StartQQLogin() { AndroidJavaClass unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer); AndroidJavaObject activity unityPlayer.GetStaticAndroidJavaObject(currentActivity); activity.Call(QQLogin, gameObject.name); // 传入接收回调的GameObject名 } // 回调处理方法 public void OnQQLoginSuccess(string jsonResult) { // 处理登录结果... }4.3 常见问题解决方案回调不执行检查GameObject名称是否匹配是否处于激活状态权限被拒绝确保在AndroidManifest.xml中声明了必要权限ClassNotFoundException确认classes.jar引用正确Proguard未移除关键类UI线程问题在Unity主线程调用Android方法避免使用async/await5. 高级技巧与性能优化5.1 使用AndroidJavaProxy建立双向通信更高效的通信方式示例// 定义接口 public interface IAndroidCallback { void OnMessage(string message); } // Unity端实现 public class UnityCallback : AndroidJavaProxy { public UnityCallback() : base(com.yourcompany.unitybridge.AndroidCallbackInterface) {} public void onMessage(string message) { // 处理消息... } } // 注册回调 AndroidJavaObject plugin new AndroidJavaObject(com.yourcompany.unitybridge.BridgePlugin); plugin.Call(setCallback, new UnityCallback());5.2 减少JNI调用开销批量处理数据避免频繁跨语言调用对性能敏感部分考虑使用C插件缓存Java类和方法IDprivate static AndroidJavaClass _unityPlayer; private static AndroidJavaObject _currentActivity; static AndroidUtils() { _unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer); _currentActivity _unityPlayer.GetStaticAndroidJavaObject(currentActivity); }5.3 内存管理注意事项及时释放AndroidJavaObject引用using (AndroidJavaObject jo new AndroidJavaObject(java.lang.String, test)) { // 使用对象... } // 自动释放避免在循环中创建大量临时对象监控Logcat中的GC_FOR_ALLOC日志6. 调试与问题排查6.1 常用调试命令# 查看Unity日志 adb logcat -s Unity # 查看系统日志 adb logcat -v time # 检查AndroidManifest合并结果 ./gradlew processDebugManifest --consoleverbose6.2 常见错误代码错误现象可能原因解决方案java.lang.NoSuchMethodError方法签名不匹配使用javap检查实际方法签名AndroidJavaException: java.lang.ClassNotFoundException类路径错误检查包名和类名是否完全一致Not running on Android player!在编辑器模式调用添加平台判断#if UNITY_ANDROID !UNITY_EDITOR6.3 使用Android Profiler检测性能问题在Android Studio中打开Profiler监控CPU和内存使用情况特别关注JNI调用的耗时检查是否有内存泄漏持续增长的Java对象我在实际项目中发现不当的JNI调用可能导致帧率下降高达30%。通过优化调用频率和数据结构最终将性能损耗控制在5%以内。