Unity与Android交互通信实战指南

1. Unity与Android交互通信的核心价值在移动应用开发领域Unity引擎与Android原生平台的交互能力一直是开发者必须掌握的硬核技能。我经历过多个需要深度整合Unity和Android功能的商业项目这种跨平台通信机制能让我们在Unity的跨平台优势基础上灵活调用Android特有的硬件API如摄像头、传感器和系统服务如通知、后台任务实现112的效果。最典型的应用场景包括在Unity游戏中集成Android原生的支付SDK调用设备特有的传感器数据如心率监测实现Unity与系统级功能如相册访问、GPS定位的深度整合混合开发中Unity与原生Android模块的协同工作2. 交互方案选型与技术解析2.1 AndroidJavaClass/AndroidJavaObject方案这是最基础的C#调用Java方案原理是通过JNI桥接实现跨语言调用。我在实际项目中发现几个关键点// 调用静态方法示例 using (AndroidJavaClass jc new AndroidJavaClass(com.unity3d.player.UnityPlayer)) { using (AndroidJavaObject jo jc.GetStaticAndroidJavaObject(currentActivity)) { jo.Call(runOnUiThread, new AndroidJavaRunnable(() { // 这里执行需要在UI线程运行的代码 })); } }重要提示所有涉及UI操作的调用必须放在主线程执行否则会导致崩溃。通过AndroidJavaRunnable可以安全切换到UI线程。参数传递时需要特别注意类型映射C#的string对应Java的StringC#的int对应Java的intC#的bool对应Java的boolean复杂对象需要实现AndroidJavaProxy2.2 UnitySendMessage方案当需要从Java反向调用C#时这是最轻量级的解决方案。但需要注意三个限制只能调用挂载在GameObject上的脚本方法参数仅支持基本类型string, float, int调用是异步的不能立即获取返回值Java端典型实现UnityPlayer.UnitySendMessage(GameObjectName, MethodName, parameter);C#端接收void MethodName(string param) { Debug.Log(收到Android调用 param); }3. 实战完整的双向通信实现3.1 基础环境搭建Unity工程配置Player Settings Other Settings中确保Package Name符合Android规范如com.company.productMinimum API Level根据需求设置建议至少API 21勾选Internet Access权限如需网络功能Android Studio模块准备dependencies { implementation com.unity3d:unity-classes:2021.3.16f1 // 与Unity版本匹配 }3.2 C#调用Java完整示例实现一个获取Android设备信息的案例public string GetDeviceInfo() { StringBuilder info new StringBuilder(); using (var versionClass new AndroidJavaClass(android.os.Build$VERSION)) { info.AppendLine($SDK版本: {versionClass.GetStaticint(SDK_INT)}); } using (var buildClass new AndroidJavaClass(android.os.Build)) { info.AppendLine($设备型号: {buildClass.GetStaticstring(MODEL)}); info.AppendLine($制造商: {buildClass.GetStaticstring(MANUFACTURER)}); } return info.ToString(); }3.3 Java调用C#完整示例Android端实现一个定时器功能// 在Activity中 private Handler handler new Handler(); private Runnable timerTask new Runnable() { int count 0; Override public void run() { UnityPlayer.UnitySendMessage(AndroidBridge, OnTimerTick, String.valueOf(count)); handler.postDelayed(this, 1000); } }; public void StartTimer() { handler.post(timerTask); } public void StopTimer() { handler.removeCallbacks(timerTask); }Unity端对应实现public class AndroidBridge : MonoBehaviour { void OnTimerTick(string count) { Debug.Log($计时器计数: {count}); } }4. 性能优化与疑难排查4.1 高频调用的性能陷阱在开发AR导航应用时我们曾遇到频繁调用Android GPS接口导致的性能问题。解决方案批处理调用将多次调用合并为一次缓存Java对象避免重复创建AndroidJavaObjectprivate static AndroidJavaObject cachedActivity; public static AndroidJavaObject GetUnityActivity() { if (cachedActivity null) { using (var player new AndroidJavaClass(com.unity3d.player.UnityPlayer)) { cachedActivity player.GetStaticAndroidJavaObject(currentActivity); } } return cachedActivity; }4.2 常见崩溃场景分析线程冲突问题现象调用Android UI相关API时崩溃解决方案使用runOnUiThread包装调用方法签名不匹配现象NoSuchMethodError异常排查使用javap检查.class文件中的实际方法签名javap -s com.your.package.ClassNameProGuard混淆问题现象Release版本调用失败解决方案在proguard-rules.pro中添加例外-keep class com.your.package.** { *; }5. 高级应用场景拓展5.1 Unity与Android Service通信实现后台服务与Unity的持续通信创建Android Servicepublic class MyService extends Service { private final IBinder binder new LocalBinder(); public class LocalBinder extends Binder { MyService getService() { return MyService.this; } } Override public IBinder onBind(Intent intent) { return binder; } public void sendDataToUnity(String data) { UnityPlayer.UnitySendMessage(...); } }Unity端绑定服务AndroidJavaObject serviceConnection new AndroidJavaObject(...); AndroidJavaClass unityPlayer new AndroidJavaClass(com.unity3d.player.UnityPlayer); AndroidJavaObject activity unityPlayer.GetStaticAndroidJavaObject(currentActivity); Intent serviceIntent new AndroidJavaObject(android.content.Intent, activity, new AndroidJavaClass(com.your.package.MyService)); activity.Call(bindService, serviceIntent, serviceConnection, AndroidJavaObject.GetStaticint(BIND_AUTO_CREATE));5.2 使用Android ARCore与Unity整合实现原生AR能力与Unity的混合使用在Android端配置ARCore Sessiontry (Session session new Session(this)) { Config config new Config(session); session.configure(config); // 将相机纹理传递给Unity int textureId UnityPlayer.currentActivity.getGLSurfaceView().getRenderer().getCameraTextureId(); session.setCameraTextureName(textureId); }Unity端通过插件接收AR数据[DllImport(YourARPlugin)] private static extern IntPtr GetNativeARSessionPtr(); void Start() { IntPtr sessionPtr GetNativeARSessionPtr(); // 将指针转换为Unity可用的AR Foundation Session }6. 工程化实践建议通信协议设计定义统一的JSON消息格式使用消息ID区分不同功能调用实现错误码体系自动化构建集成task exportUnityLibs(type: Copy) { from ${unityProjectPath}/libs into src/main/libs }跨平台兼容方案#if UNITY_ANDROID !UNITY_EDITOR // Android特定实现 #else // 编辑器/其他平台模拟实现 #endif安全通信机制关键调用添加HMAC签名验证使用AES加密敏感数据传输实现调用频率限制在最近的一个电商AR项目中我们通过优化通信协议和引入二进制数据传输将Unity与Android间的数据交换效率提升了70%。关键是把所有频繁调用的传感器数据打包成二进制格式通过MemoryStream一次传输而不是多次字符串调用。