Unity与iOS平台交互和原生插件开发

Unity引擎虽然很强大,但是很多的时候还是需要运行平台的原生功能,这时候光靠Unity是做不到的。比如iOS平台上我们要从一个应用唤起另一个应用,在我们的游戏中打开一个网页,或者是直接嵌入一个iOS原生的界面(也就是现在接SDK的时候要做的事情)。 很多兄弟在刚接触的时候一头雾水,不知道从哪里入手。也有很多兄弟搞过一次一段时间后就忘记地一干二净。于是我说,入门的和忘记的人多了,就有了这个文章的诞生!希望能问新手打开新世界的大门,让忘记细节的老兵可以快速回忆。

Unity Call iOS

这里我们来实现从Unity调用iOS中OC实现的方法。

  • 在C#文件中,声明一个extern方法,如下:

[DllImport("__Internal")]
private static extern void CalliOSNativeFunction();
  • 新建我们在iOS原生环境下运行的源文件,如: iOSBridgePlugin.mm,iOSBridgePlugin.h。

  • 定义我们要调用的方法。

iOSBridgePlugin.h文件:

 extern "C" {
     void CalliOSNativeFunction();
 }
iOSBridgePlugin.mm文件:

 #import "iOSBridgePlugin.h"

 void CalliOSNativeFunction(){
     NSLog(@"[iOS Native] I am running!");
 }
  • 在XCode中,.m是C或者Object-C类型的文件,.mm是C++文件,两者在被编译时有不同的处理。所以我这里使用了.mm文件,需要加上:

    extern "C"{
       /*
       包裹我们要声明的方法。
       */
    }
  • 将源文件放在Assets/Plugins/iOS/目录下,这样源文件在Unity打包iOS工程时会自动将文件拷贝到XCode工程中的Plugins/iOS/目录下,并且在工程中添加正确的引用。

  • 打包,跑一跑我们刚才实现的接口。原生插件的开发难度似乎就是个纸老虎。 现在我们已经可以顺利地从Unity调用iOS的方法了,那么剩下来iOS原生系统支持的事情我们都能实现了,开始为所欲为吧!

实现“HellWorldSDK” 很多时候我们要接入项目的第三个SDK都有自己的iOS原生界面,我在只需要成功绘制出界面就能完成大部分的工作了。 这里我们实现一个自己的SDK来接入到我们的测试工程里

  • 创建一个界面,叫做HelloWorldSDKViewController,继承UIViewController。

  • 界面上有简单的标题文字,一个矩形图案和一个按钮。

  • 调用我们的SDK。修改我们原先的iOSBridgePlugin.m文件。

 void CalliOSNativeFunction(){
     NSLog(@"[iOS Native] I am running!");
     [[HelloWorldSDKViewController sharedInstance] ShowHelloWorld];
 }
 [GetAppController().rootViewController presentViewController:_sharedInstance
                                                     animated:true
                                                   completion:nil];

Unity生成的项目中,所有的场景都是一个ViewController,要绘制我们SDK的界面,就是在Unity的ViewController上绘制一个新的界面。

  • 从我们的SDK返回。

    [GetAppController().rootViewController dismissViewControllerAnimated:true completion:nil];

关闭我们的界面也是一样,从Unity的ViewController上销毁我们的界面。

HelloWorldSDKViewController.h:

#ifndef HelloWorldSDKViewController_h
#define HelloWorldSDKViewController_h
#import <Foundation/Foundation.h>
@interface HelloWorldSDKViewController : UIViewController{

}
@end
#endif
HelloWorldSDKViewController.m:

#include "HelloWorldSDKViewController.h"

@implementation HelloWorldSDKViewController

// 用static声明一个类的静态实例;
static HelloWorldSDKViewController *_sharedInstance = nil;

//使用类方法生成这个类唯一的实例
+(HelloWorldSDKViewController *)sharedInstance{
    if (!_sharedInstance) {
        _sharedInstance =[[self alloc]init];
    }
    return _sharedInstance;
}

-(void) viewDidLoad{
    [super viewDidLoad];
    self.view.backgroundColor = [UIColor whiteColor];

    UIButton *btnBack = [UIButton buttonWithType:UIButtonTypeSystem];
    btnBack.frame = CGRectMake(0.5f * self.view.bounds.size.width - 100, 300, 200, 40);
    btnBack.layer.borderWidth = 1;
    [btnBack setTitle:@"返回" forState:UIControlStateNormal];
    [btnBack addTarget:self
                action:@selector(BackToUnityScene:)
      forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:btnBack];

    UILabel *title = [[UILabel alloc]init];
    title.frame = CGRectMake(0.5f * self.view.bounds.size.width - 100, 100, 200, 40);
    title.text = @"Hello World";
    [self.view addSubview:title];
}

-(void) ShowHelloWorld{
    [GetAppController().rootViewController presentViewController:_sharedInstance
                                                        animated:true
                                                      completion:nil];
}

-(void) BackToUnityScene:(id)sender {
    NSLog(@"[HelloWorldSDK] Back to unity scene");
    [GetAppController().rootViewController dismissViewControllerAnimated:true completion:nil];
}
@end

iOS Call Unity

现在我们从Unity调用iOS的接口已经成功了,那么下面我们就会想从iOS是否可以调用我们Unity中用C#实现的方法呢?答案是肯定的! 我们可以用UnitySendMessage来实现。

UnitySendMessage("GameObjectName1", "MethodName1", "Message to send");

通过这个接口我们可以清楚的知道,我们能调用的接口必须是挂在GameObject上的脚本上的某一个方法。 让我们来动手实现一个方法。

  • 在C#文件中实现我们需要调用的方法

    private void Callback_iOSReturnMessage(string message){
       Debug.Log("[Unity callback] Message is :" + message);
    }
  • 从我们的SDK返回时,发送消息

    -(void) BackToUnityScene:(id)sender {
       NSLog(@"[HelloWorldSDK] Back to unity scene");
       UnitySendMessage("BridgeGameObject", "Callback_iOSReturnMessage", "[Return Unity Successful]");
       [GetAppController().rootViewController dismissViewControllerAnimated:true completion:nil];
    }

    打包运行!

Last updated