集成Unity3D到iOS应用程序中

如果想让原生平台（例如 Java/Android、Objective C/iOS 或 Windows Win32/UWP）包含 Unity 功能，可以通过Unity 生成UnityFramework静态库包含到项目中进行实现。

Unity 从2019.3 开始支持将 Unity 运行时组件集成到原生平台项目中，从而将Unity 静态库用于其他应用程序中。

这样就可以以嵌入的方式让APP使用 3D 或 2D 实时渲染的内容，例如 AR 体验、与 3D 模型交互、2D 迷你游戏等。

Unity 静态库提供了多种方法来管理如何在原生应用程序中加载、激活和卸载Unity3DPlayer。

以下平台目前支持Unity 用作库：Android，iOS，Windows 和通用 Windows 平台。

使用Unity构建iOS工程

先使用 Unity 构建 一个Xcode 项目，然后制作iOS静态库。

每个 Unity iOS Xcode 项目具有以下结构：

UnityFramework 部分，其中包含源、插件和相关框架。它还生成 UnityFramework.framework 文件。

Unity-iPhone 部分，其中包含应用程序需要的资源数据和运行库。Unity-iPhone Target对 UnityFramework 具有单一依赖关系,所以直接运行Unity-iPhone,构建出UnityFramework 。

要将 Unity 集成到另一个 Xcode 项目中，可以通过将 UnityFramework.framework 文件添加到原生 Xcode 项目的应用程序 (Application) 的依赖库中，并设置成嵌入 (Embedded Binaries) 。完成此操作后，可以使用 UnityFramework 类来控制 Unity 运行时。

可通过 UnityFramework Objective-C 类（该类是 UnityFramework.framework 的主体类）的实例来控制 Unity 运行时：

UnityFramework提供了一系列的方法，举例如下：

+ (UnityFramework*)getInstance; 单例类方法，可将实例返回到 UnityFramework。
- (UnityAppController*)appController; 返回 UIApplicationDelegate 的 UnityAppController 子类。这是原生端的根 Unity 类，可以访问应用程序的视图相关对象，例如 UIView、UIViewControllers、CADisplayLink 或 DisplayConnection。
- (void)setDataBundleId:(const char*)bundleId; 设置捆绑包，Unity 运行时应在其中查找 Data 文件夹。有关更多信息，请参阅 Data 文件夹的相关文档。应在调用 runUIApplicationMainWithArgc 或 runEmbeddedWithArgc 之前调用此方法。
- (void)runUIApplicationMainWithArgc:(int)argc argv:(char*[])argv; 从没有其他视图的主要方法中运行 Unity 的默认方式。

 

制作iOS静态库

1.先创建一个UnityCallNative类，可以在iOS项目中创建。

UnityCallNative.h中定义声明一个供unity调用原生的方法，注意这里的方法定义必须使用C语法。

UnityCallNative.m中实现.h中定义的接口，注意实现的地方是除@implementation-end只外的地方，也就是直接把@implementation-end以及中间的内容都删除，然后使用C语言来实现，C语言的调用部分可以使用OC实现。

比如：

UnityCallNative.h文件声明方法

extern "C" {
void outputAppendString("test1", "test2");
}

UnityCallNative.m文件实现方法

void outputAppendString(string str1, string str2) {
....
}

2.将完成后的UnityCallNative类添加到Unity项目中

在Unity的Project/Asserts/Plugins/ios/目录下添加这2个文件。

3.通过Unity项目File-Buile Settings-iOS-Build 重新构建出新的Unity-iPhone项目

4.把Data资源文件夹，UnityCallNative.h 的Target MemberShips 设置到UnityFromework下（打勾），同时把UnityCallNative.h作用域设置成public

5.构建UnityFramework工程，生成静态库

6.把UnityFramework静态库导入到iOS工程中，同时在General-Libaray,Frameworkd设置成Embed&Sign

Unity3D与iOS原生交互

Unity3D调iOS

1.在Unity的脚本文件中使用原生项目暴露的方法

Unit3D中新建一个脚本文件，引入交互服务。

using System.Runtime.InteropServices;

public class ChangeLabel : MonoBehaviour
{
[DllImport("__Internal")]
static extern void outputAppendString(string str1, string str2); // 声明ios原生定义的C方法

void Start() {
#if UNITY_IPHONE
outputAppendString("test1", "test2"); // 调用ios原生定义的C方法
#endif
}
}

iOS原生调用Unity3D

原生调Unity3D通过下面这一句函数就够了。

举个例子 : 

UnitySendMessage("UIChargeMoneyPage", "callback", "0");

在UnityInterface.h声明中声明了下面的函数

UnitySendMessage(const char * GameObjectName, const char *methodName, const char *msg);

GameObjectName： Unity场景中的游戏对象

methodName： 游戏对象下绑定的脚本中的函数名

msg：函数的参数

另外：

UnityInterface.h文件是Unity导出的iOS项目中包含的。

在发送消息到Unity前，要确保成功导入了UnityInterface.h文件。

 

参考文章：

https://docs.unity3d.com/cn/2021.1/Manual/UnityasaLibrary-iOS.html

https://juejin.cn/post/6844903933790388231

https://blog.51cto.com/myselfdream/2559580

https://blog.51cto.com/myselfdream/2559599

https://blog.csdn.net/weixin_42714258/article/details/122454019