---
title: Unity 中的 Java 原生接口 API
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/platform-specific/android/developing/plugins-for/plugins-java-code-from-c-sharp/jni-apis-unity
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/platform-specific/android/developing/plugins-for/plugins-java-code-from-c-sharp/jni-apis-unity.md
last_updated: 2026-10-30
generated_at: 2026-11-16T08:11:35.502Z
locale: zh-cn
---

# Unity 中的 Java 原生接口 API

> 了解 Unity 中的 Java 原生接口 API，您可以使用这些 API 从 C# 脚本ava/Kotlin 代码。

Unity 提供低关卡和高关卡 [Java 原生接口](https://developer.android.com/training/articles/perf-jni) (JNI) API，允许您通过 C# 脚本与 Java 代码交互。

## 低级 API##low-level-api

低关卡 [AndroidJNI](/engine/6000.0/script-reference/unityengine/androidjni.md) 类封装 JNI Calls 并提供直接映射到 JNI 方法的 Static 方法。[AndroidJNIHelper](/engine/6000.0/script-reference/unityengine/androidjnihelper.md) API 提供了主要由高级关卡 API 使用的 helper 功能，但在某些情况下很有用。

## 高级关卡 API##high-level-api

高级关卡 [AndroidJavaObject](/engine/6000.0/script-reference/unityengine/androidjavaobject.md)、[AndroidJavaClass](/engine/6000.0/script-reference/unityengine/androidjavaclass.md) 和 [AndroidJavaProxy](/engine/6000.0/script-reference/unityengine/androidjavaproxy.md) 类自动执行 JNI Calls 所需的大量任务。它们还使用缓存来更快地对 Java 进行 Calls。`AndroidJavaObject` 和 `AndroidJavaClass` 的组合建立在 `AndroidJNI` 和 `AndroidJNIHelper` 顶部，但它们还包含其他功能，例如可用于访问 Java 类的 Static 成员的 Static 方法。

此外，Unity 提供了 [AndroidApplication](/engine/6000.0/script-reference/unityengine/android/androidapplication.md) 类来简化对应用程序`currentActivity`、`currentContext`和`currentConfiguration`实例的访问。此类还允许您根据应用程序的要求委托 ON UI 或主要线程的代码执行。

`AndroidJavaObject` 和 `AndroidJavaClass` 实例分别与 [java.lang.Object](https://docs.oracle.com/javase/7/docs/api/java/lang/Object.html) 和 [java.lang.类](https://docs.oracle.com/javase/7/docs/api/java/lang/Class.html)的实例具有一对一 Mapping。它们提供与 Java/Kotlin 代码的三种交互：

* [调用](/engine/6000.0/script-reference/unityengine/androidjavaobject/call.md)方法。
* [获取](/engine/6000.0/script-reference/unityengine/androidjavaobject/get.md) Field 的值。
* [设置](/engine/6000.0/script-reference/unityengine/androidjavaobject/set.md) Field 的值。

每个交互也有 Static 版本：

* [CallStatic](/engine/6000.0/script-reference/unityengine/androidjavaobject/callstatic.md) 以调用 Static 方法。
* [GetStatic](/engine/6000.0/script-reference/unityengine/androidjavaobject/getstatic.md) 获取 Static Field 的值。
* [SetStatic](/engine/6000.0/script-reference/unityengine/androidjavaobject/setstatic.md) 用于设置 Static Field 的值。

当您获取 Field 的值或调用返回值的方法时，可使用[泛型](https://docs.microsoft.com/en-us/dotnet/csharp/fundamentals/types/generics)指定返回类型。设置Field的值还会使用泛型来指定要设置的Field的类型。对于不返回值的方法，存在常规、非 Generic 版本的[调用](/engine/6000.0/script-reference/unityengine/androidjavaobject/call.md)。

> **Important:**
>
> 必须作为`AndroidJavaObject`访问 Any [非原始类型](http://developer.android.com/reference/java/lang/Class.html)。唯一的异常是您直接访问的字符串，即使它们不代表 Java 中的原始类型。

## 其他资源##additional-resources

* [代码示例：从 C# 脚本](/engine/6000.0/manual/platform-specific/android/developing/plugins-for/plugins-java-code-from-c-sharp/high-level-api-code-examples.md)调用 Java/Kotlin 代码
* [调用 Java/Kotlin 代码的最佳做法](/engine/6000.0/manual/platform-specific/android/developing/plugins-for/plugins-java-code-from-c-sharp/call-java-kotlin-code-best-practices.md)
