Unity3D-消息机制实现与Android的通信

一、跨平台通信的背景与挑战

在混合开发场景中，Unity3D作为跨平台游戏引擎，常需与Android原生功能深度集成。例如调用设备传感器、支付系统或第三方SDK时，单纯依赖Unity的API往往无法满足需求。此时，通过消息机制实现Unity与Android的双向通信成为关键技术。

1.1 通信需求场景

• 硬件功能调用：NFC读取、指纹识别、蓝牙设备控制
• 系统服务集成：推送通知、后台服务、权限管理
• 性能优化：将计算密集型任务卸载至原生层
• 第三方服务接入：微信登录、支付宝支付、地图SDK

1.2 传统方案的局限性

早期开发者常通过Application.OpenURL()或Unity插件实现简单交互，但存在以下问题：

• 参数传递受限（仅支持字符串）
• 回调机制缺失
• 无法处理复杂数据结构
• 线程安全问题

二、Unity3D与Android通信的核心机制

2.1 AndroidJavaProxy与接口回调

Unity通过AndroidJavaProxy类实现Java接口的代理，这是双向通信的基础。典型实现流程：

// Unity端定义接口
public interface IAndroidCallback {
    void OnDataReceived(string data);
}
// 创建代理类
public class CallbackProxy : AndroidJavaProxy {
    private Action<string> callback;
    public CallbackProxy(Action<string> cb) : base("com.example.IAndroidCallback") {
        callback = cb;
    }
    void onDataReceived(string data) {
        callback?.Invoke(data);
    }
}

2.2 UnityPlayerActivity重写

通过继承UnityPlayerActivity，可拦截Android生命周期事件：

public class CustomUnityActivity extends UnityPlayerActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 初始化原生服务
    }
    public void sendToUnity(String message) {
        UnityPlayer.UnitySendMessage("GameManager", "OnAndroidMessage", message);
    }
}

2.3 消息队列与线程管理

为避免主线程阻塞，需建立异步通信机制：

// Android端使用HandlerThread
private Handler mWorkerHandler;
private HandlerThread mWorkerThread;
private void initWorkerThread() {
    mWorkerThread = new HandlerThread("UnityCommThread");
    mWorkerThread.start();
    mWorkerHandler = new Handler(mWorkerThread.getLooper());
}
public void postToUnityAsync(final String message) {
    mWorkerHandler.post(() -> {
        UnityPlayer.UnitySendMessage(...);
    });
}

三、完整通信流程实现

3.1 环境配置

1. AndroidManifest.xml修改：

   <activity android:name=".CustomUnityActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
   </activity>

2. Unity项目设置：

   • 在Player Settings中指定自定义Activity
   • 启用Custom Main Manifest

3.2 消息发送实现

Unity → Android：

public class AndroidBridge : MonoBehaviour {
    private static AndroidJavaObject unityActivity;
    void Start() {
        AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
        unityActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
    }
    public void CallAndroidMethod(string methodName, string param) {
        unityActivity.Call(methodName, param);
    }
}

Android → Unity：

// 在原生代码中调用
public void notifyUnity(String gameObject, String method, String param) {
    UnityPlayer.UnitySendMessage(gameObject, method, param);
}

3.3 复杂数据传输方案

对于结构化数据，推荐使用JSON序列化：

// Unity端
public void ProcessComplexData(string json) {
    var data = JsonUtility.FromJson<CommData>(json);
    // 处理数据...
}
// Android端
public String getDeviceInfo() {
    CommData data = new CommData();
    data.model = Build.MODEL;
    data.sdkVersion = Build.VERSION.SDK_INT;
    return new Gson().toJson(data);
}

四、性能优化与最佳实践

4.1 通信频率控制

• 避免每帧调用（建议<30fps）
• 使用消息批处理：

  public void sendBatchData(List<String> dataList) {
    StringBuilder sb = new StringBuilder();
    for (String data : dataList) {
        sb.append(data).append("|");
    }
    UnityPlayer.UnitySendMessage(..., sb.toString());
  }

4.2 内存管理

• 及时释放AndroidJavaObject引用
• 避免在Unity主线程创建大量临时对象
• 使用对象池模式管理通信对象

4.3 错误处理机制

try {
    using (AndroidJavaClass plugin = new AndroidJavaClass("com.example.Plugin")) {
        plugin.CallStatic("nativeMethod");
    }
} catch (Exception e) {
    Debug.LogError("Android通信失败: " + e.Message);
}

五、典型应用案例

5.1 支付系统集成

1. Unity端初始化支付参数
2. 通过接口传递至Android原生支付SDK

3. 监听支付结果回调

   // Android支付回调实现
   public class PaymentCallback : AndroidJavaProxy {
    public PaymentCallback() : base("com.example.IPaymentCallback") {}
    public void onSuccess(String transactionId) {
        UnityPlayer.UnitySendMessage("PaymentManager", "OnPaymentSuccess", transactionId);
    }
    public void onFailure(int errorCode, String message) {
        // 错误处理...
    }
   }

5.2 传感器数据采集

// Unity端传感器管理器
public class SensorController : MonoBehaviour {
    private AndroidJavaObject sensorService;
    void Start() {
        sensorService = new AndroidJavaObject("com.example.SensorService");
        sensorService.Call("startAccelerometer", new CallbackProxy(OnSensorData));
    }
    private void OnSensorData(string json) {
        var data = JsonUtility.FromJson<SensorData>(json);
        // 更新Unity场景...
    }
}

六、调试与问题排查

6.1 常见问题解决方案

1. ClassNotFoundException：

   • 检查proguard规则
   • 确认类名完全限定

2. UnitySendMessage失败：

   • 验证GameObject是否存在
   • 检查方法名大小写

3. ANR问题：

   • 将耗时操作移至子线程
   • 使用AsyncTask或RxJava

6.2 日志系统集成

// Android端统一日志
public class UnityLogger {
    public static void d(String tag, String message) {
        Log.d(tag, message);
        UnityPlayer.UnitySendMessage("DebugConsole", "LogMessage", 
            String.format("[%s] %s", tag, message));
    }
}

七、未来发展趋势

1. ARCore深度集成：通过原生层获取更精确的环境数据
2. 机器学习框架接入：利用TensorFlow Lite进行端侧推理
3. 5G网络优化：建立高效的大数据传输通道
4. 跨平台消息标准：推广如gRPC的通用通信协议

本文详细阐述了Unity3D与Android通信的核心技术，通过实际案例展示了从简单调用到复杂系统集成的完整实现路径。开发者可根据项目需求，选择适合的通信方案，并遵循最佳实践确保系统稳定性。随着移动设备性能的不断提升，这种跨平台通信模式将在AR/VR、物联网等领域发挥更大价值。