1. 调用环境
根据Unity用户手册描述,可以知道Unity调用Android逻辑,Android逻辑以Plugins的概念被Unity执行;
Plugins存在方式主要有两种:
1)so库,使用Android JNI API方式提供接口,与其他平台基本一样,是比较通用的方式;
2)jar库/aar库,使用JAVA API方式提供接口,Android平台特有的方式,是该分享关注的部分;
描述jar库/aar库方式时,假设开发语言均为Java,不是Kotlin;
2. 调用方式
C#调用Java
Unity提供反射接口调用Java的类方法;
Java调用C#
1)Java代码中通过UnityPlayer调用MonoBehavior的方法;
方法执行在Unity主线程。
2)使用AndroidJavaProxy,调用Java方法时,传入Java监听接口映射的AndroidJavaProxy对象;
方法执行在Android调用方法所在线程。
3. 搭建通信方法
Unity与Android通信时,Unity作为UI展示端,Android插件作为数据服务端;
通信方式可设计为C/S服务架构,并结合发布/订阅模式;
1)Unity作为Client端和订阅端;
2)Android作为Server端和发布端;
3)发布/订阅模式,可以支持sticky方式订阅;
4. 结合调用方式实现通信方法
C#调用Java使用反射调用,返回值可能是同步返回也可能是异步返回的,这里我们可以统一通过AndroidJavaProxy返回;
例如我们使用AndroidJavaProxy封装byte数组数据回调用:
1)首先定义有Android接口:
public interface ByteArrayCallback {
void callback(ByteArrayCallbackResult result);
}
2)Unity内,Android传递byte数组到Unity,使用对象封装提高效率:
public class ByteArrayCallbackResult {
public byte[] value;
public ByteArrayCallbackResult(byte[] bArr) {
this.value = bArr;
}
}
3)定义Unity的AndroidJavaProxy的子类,实现ByteArrayCallback的借口方法:
class AndroidByteArrayCallback : AndroidJavaProxy {
public AndroidByteArrayCallback(Action<byte[]> callback) : base("com.github.daweizhou89.ByteArrayCallback") {
_callback = callback;
}
public void callback(AndroidJavaObject result) {
AndroidJavaObject byteArrayObject = result.Get<AndroidJavaObject>("value");
var bytes = ConvertAndroidByteArray(byteArrayObject);
byteArrayObject.Dispose();
_callback(bytes);
_callback = null;
}
public static byte[] ConvertAndroidByteArray(AndroidJavaObject arrayObject) {
return (byte[])(Array)AndroidJNIHelper.ConvertFromJNIArray<sbyte[]>(arrayObject.GetRawObject());
}
Action<byte[]> _callback;
}
4)基于C/S架构,可以通过uri方式区分调用或订阅,如下:
RequestManager.Request("daweizhou89://test/request", new AndroidByteArrayCallback(requestCallback));
SubscribeManager.Subscribe("daweizhou89://test/subscribe", new AndroidByteArrayCallback(subscribeCallback))
RequestManager的反射封装,SubscribeManager同理:
public static class RequestManager {
public static Request(string url, AndroidJavaProxy proxy) {
AndroidJavaClass clazz = new AndroidJavaClass("com.github.daweizhou89.RequestManager");
clazz.CallStatic(url, proxy);
}
}
RequestManager和SubscribeManager的Java代码中,可以通过url做分发和做请求记录;
当请求处理完后或分发事件时,取callback进行回调:
ByteArrayCallback callback = RequestManager.getCallback(url);
callback.callback(new ByteArrayCallbackResult(new byte[0]));
参考资料:
https://docs.unity3d.com/cn/2021.1/Manual/PluginsForAndroid.html
https://docs.unity3d.com/cn/current/ScriptReference/AndroidJavaProxy.html