程序丨Unity与iOS交互便捷指南

作者： Mitty腾讯游戏学院2018-11-21

早年间在Unity中接入平台相关的功能，如SDK，IAP，IAB，PUSH，WebView等等需要和原生组件交互的时候，就要应用到AndroidJavaClass和DllImport，后来的SDK在这方面做得越来越好，几乎不需要开发去手动的额外编写这部分的内容，但最近项目中几处需求有变，又需要用到这些。在这里先提供Unity与iOS交互的指南，之后再补充Android的部分。

iOS篇

在Unity当中，要调用iOS原生的代码，需要通过特性Attribute，[DllImport(__Internal")]

下面是Microsoft Docs定义：

只可以应用在方法上，指示该属性化方法由非托管动态链接库 (DLL) 作为静态入口点公开。

这是官方的解释，换句话说，应用了DllImport特性的方法，是由非拖管的第三方平台的语言来实现。

比如我现在要在Unity端写一个按钮，点击按钮后，调出iOS原生的Alert弹框，具体流程如下：

1.在Unity中新建一个脚本xxx.cs，并定义Alert弹框方法，比如：

这个方法必须是static extern进行修饰。因为要由非拖管的第三方平台来实现，所以我们加上特性Attribute。

(注：需要引入命名空间 using System.Runtime.InteropServices;)

2.我们做一个简单的按钮来直接的调用它。

这里要使用UNITY_IOS宏来进行平台的区分，相应的还有UNITY_ANDROID，我们直接传入string即可。

3.配置好Build Settings,导出Xcode工程，在导出的Xcode里，我们可以在Xcode工程结构的Classes或是Libraries下新建特定的类，并实现ShowAlertMessage方法。

这里我新建的类叫iOSWrapper，一般也命名为xxxImpl.h/mm。

4.首先新建iOSWrapper.h 头文件。

这里我定义了UnityGameObject，可以忽略它，这是以前遗留的代码，主要是在使用UnitySendMessage时，用来定义GameObject的值，如果要声明其它OC的对象，也需要像这样来定义。

这是一个iOSWrapper类的成员方法，用于实现弹窗的创建和显示。

这是一个单例，你也可以动态的创建，我只是习惯将他们常驻内存以便随时使用。

5.实现iOSWrapper.h 头文件，我们需要创建一个iOSWrapper.m类，并引入头文件。

在iOSWrapper类中，定义类的实例instance，并实现sharedInstance方法来创建单例。

showAlertMessage方法我们通过UIAlertView来实现弹出对话框。

（注：8.0以后，使用UIAlertController实现，UIAlertView被废弃，我这里目标平台是7.0，依然可以使用。）

另外，Unity端传递过来的字符串都是char数组，我们需要将它转换为OC的NSString，同样的，当我们需要从iOS传递字符串给Unity时，也需要将NSString转换为char数组，在Unity的官方中有封装了两个方法，后面会提供上来。

6.这一步，我们需要实现C#中[DllImport(__Internal")]应用的方法在原生中的实现。

这里*.m文件是默认支持OC和C代码的，如果我们需要支持C++，则需要将*.m修改为*.mm，并修改文件的Type为Objective-C++ Source.

我们也需要将[DllImport("__Internal")]应用的方法定义在extern "C"下，extern "C"是告诉编译器这些方法要以C的函数命名规则来编译和链接。

为何要使用"extern C"?

因为C++是支持多态的，比如函数重载，所以C++编译器中对函数的命名都是以方法名+参数类似的形式，比如void foo(int x,int y)，C++编译器会产生foo_int_int之类的名字，而C语言不支持多态，不支持函数重载，命名规则就是函数名，那么，如果我不加以限定，默认以C++的函数命名规则时，在C++中调用C函数时，就会出现类似无法找到在obj模块中C函数定义，UnsatisfiedLinkError:xxx之类的异常。

通常只要不是通过C++来调用，extern "C"都不是必须要加的。

extern "C" 定义在在iOSWrapper.mm类的外部，即：

下面：

上面有提到过，Unity传递过来的字符串是char数组，我们需要将他转换成NSString。

在Unity官方的例子中对此做了封装，可以拿过来直接使用C风格字符串转换NSString。

相应的，下面是NSString字符串转换为C风格字符串。

这两个方法要定义到extern "C"的上面，因为C语言是面向过程的，如果定义在extern "C"的下面，会提示找不到函数。

字符串是Unity与平台之间交互最频繁的操作。

这样，在Unity端打开一个iOS原生弹窗的功能就实现了，此时要将编写完成的iOSWrapper.h和iOSWrapper.mm文件，拷贝到Unity->Plugins->IOS下，这样生成xcode工程时，就会拷贝到Xcode的Libraries目录下。

现在实现了Unity端调用iOS端原生的组件API（窗口），我如何从原生iOS端传递数据给Unity?

这里就要使用到UnitySendMessage。

三个参数：对象名，方法名，参数。

这里的对象名在我们当前Scene中Hierarchy下某个Obj，method方法名是Obj下绑定的xx脚本中的method，msg即是我们从平台端传递回来的参数，UnitySendMessage是iOS和Android通用的。

比如就以上面弹框为例，我们需要将弹框的内容再返回到Unity端，只需要这样：