版本:Unity 6 (6000.0)
语言:英语
导入 Android 原生插件
Java 和 Kotlin 源代码插件

调用 Android 代码的原生插件

在 Android 中调用原生 插件在 Unity 外部创建的一组代码,用于在 Unity 中创建功能。Unity 中可以使用两种类型的插件:托管插件(使用 Visual Studio 等工具创建的托管 .NET 程序集)和原生插件(特定于平台的原生代码库)。更多信息
请参阅 术语表
代码的过程与标准 原生插件在 Unity 外部创建的特定于平台的原生代码库,用于在 Unity 中使用。允许您访问诸如操作系统调用和第三方代码库等功能,否则 Unity 将无法使用这些功能。更多信息
请参阅 术语表
相同。

注意:如果您使用单独的 C/C++ 源文件作为插件,请在 DllImport 属性中使用 __Internal 作为插件名称。

最佳实践是在额外的 C# 代码层中包装所有原生插件方法调用,该代码层

  • 检查 Application.platform,并且仅在应用程序使用您为其编译原生插件的架构在 Android 设备上运行时才调用原生方法。在其他平台和架构上,额外的 C# 代码层应该返回虚拟值。
  • 使用 平台定义 控制平台依赖代码编译,并且仅编译在具有插件的平台上使用插件的代码。

示例包

AndroidNativePlugin.unitypackage zip 文件包含原生代码插件的简单示例,以 Unity 包的形式分发。

该示例演示了如何从 Unity 应用程序调用 C++ 代码。该包包含一个 场景场景包含游戏的环境和菜单。将每个唯一的场景文件视为一个独特的关卡。在每个场景中,您放置环境、障碍物和装饰,实质上是分段设计和构建游戏。更多信息
请参阅 术语表
,该场景显示了原生插件计算的两个值的总和。要编译插件,请使用 Android NDK。有关如何通过 Unity Hub 安装 Android NDK 的信息,请参阅 Android 环境设置

要安装示例

  1. 下载 zip 文件。
  2. 解压缩 AndroidNativePlugin.unitypackage 文件。
  3. 在 Unity 项目中,单击 Assets > Import Package > Custom Package
  4. Import Package 文件对话框中,找到并选择解压缩的 AndroidNativePlugin.unitypackage 文件。
导入 Android 原生插件
Java 和 Kotlin 源代码插件