文档

Unity 引擎

Unity 引擎

Unity 中的 Java 原生接口 API

了解 Unity 中的 Java 原生接口 API,您可以使用这些 API 从 C# 脚本ava/Kotlin 代码。
阅读时间3 分钟最后更新于 5 天前

Unity 提供低关卡和高关卡 Java 原生接口 (JNI) API,允许您通过 C# 脚本与 Java 代码交互。

低级 API

低关卡 AndroidJNI 类封装 JNI Calls 并提供直接映射到 JNI 方法的 Static 方法。AndroidJNIHelper API 提供了主要由高级关卡 API 使用的 helper 功能,但在某些情况下很有用。

高级关卡 API

高级关卡 AndroidJavaObject、AndroidJavaClass 和 AndroidJavaProxy 类自动执行 JNI Calls 所需的大量任务。它们还使用缓存来更快地对 Java 进行 Calls。
AndroidJavaObject
和
AndroidJavaClass
的组合建立在
AndroidJNI
和
AndroidJNIHelper
顶部,但它们还包含其他功能,例如可用于访问 Java 类的 Static 成员的 Static 方法。
此外,Unity 提供了 AndroidApplication 类来简化对应用程序
currentActivity
、
currentContext
和
currentConfiguration
实例的访问。此类还允许您根据应用程序的要求委托 ON UI 或主要线程的代码执行。
AndroidJavaObject
和
AndroidJavaClass
实例分别与 java.lang.Object 和 java.lang.类的实例具有一对一 Mapping。它们提供与 Java/Kotlin 代码的三种交互:
每个交互也有 Static 版本:
当您获取 Field 的值或调用返回值的方法时,可使用泛型指定返回类型。设置Field的值还会使用泛型来指定要设置的Field的类型。对于不返回值的方法,存在常规、非 Generic 版本的调用。
重要
必须作为
AndroidJavaObject
访问 Any 非原始类型。唯一的异常是您直接访问的字符串,即使它们不代表 Java 中的原始类型。

其他资源