Unity3D 接入IOS SDK

Unity3D 开发游戏需要接入平台方的SDK才能够正式发布，本文记录IOS SDK接入的流程。

Unity与IOS的互调

要实现游戏SDK的接入，首先要解决的是Unity3D与原生IOS代码之间的相互调用问题。Unity使用C#作为开发语言，而IOS采用Objective-C作为开发语言，如何让C#调用OC代码，或者让OC调用C#代码。所幸OC和C#都支持直接嵌入C/C++代码，这里使用C作为两者之间的桥梁。

为了简化两者之间的接口调用和数据传递，在设计Unity与IOS SDK之间的接口时，Unity调用SDK只有一个接口，而SDK调用Unity也只有一个接口。由于平台方的SDK差异性较大，如何保证一个接口可以解决问题？这里我们开发了一个通用SDK层，游戏只会与通用SDK层交互，而由通用SDK层再与具体的平台SDK对接。

Unity中调用SDK层的功能：

using System.Runtime.InteropServices;
using Cross;
using UnityEngine;

namespace MuGame
{
    public class IOSPlatformSDK : IPlotformSDK
    {
        //!--IOS插件声明，所有unity调用ios SDK插件走这里
        [DllImport("__Internal")]
        public static extern void CallSDKFunc(string type, string jsonpara);

unity中所有的调用都转化为CallSDKFunc,该函数由通用SDK提供，参数type表示功能分类，jsonpara是以json字串表示的一系列参数。

通用SDK调用返回结果给Unity

//!---------------------------外部接口声明--------------------------------------------
#if defined(__cplusplus)
extern "C"{
#endif
    extern void UnitySendMessage(const char*, const char*, const char*);
#if defined(__cplusplus)
}
#endif

这里使用unityengine.dll提供的C接口UnitySendMessage,这里第1个char* 表示接受该消息的GameObject的name, 第2个表示该GameObject的脚本中接受消息的函数名，第3个表示传递的数据，这里我们还是使用json来传递，同时附带消息类型。

SDK暴露的C接口的声明与定义

#if defined(__cplusplus)
extern "C" {
#endif    
    //游戏层访问SDK的接口
    void CallSDKFunc(char *type, char * jsonpara)
    {
        if(connector == NULL)
        {
            connector = [SDKConnector sharedInstance];
        }
        [connector _CallSDKFunc :CreateNSString(type) :CreateNSString(jsonpara)];
    }
    
#if defined(__cplusplus)
}
#endif

这里CallSDKFunc即上述Unity调用SDK的接口，在OC层，直接由SDKConnector类接收，并分发处理。

通用SDK

SDKConnector负责消息的分发

- (void)_CallSDKFunc :(NSString*)type :(NSString*)jsonpara
{
    NSLog(@"[SDK] Recevie cmd = %@   jsonpara = %@\n",type,jsonpara);
    if ([type isEqualToString:@"login"])
    {//登录
        [LanPlatform login:[SDKListener sharedInstance]];
    }
    else if ([type isEqualToString:@"loginout"])
    {//登出
        [LanPlatform logout:[SDKListener sharedInstance]];
    }
    else if ([type isEqualToString:@"switchAccount"])
    {//切换账号
        [LanPlatform switchAccount:[SDKListener sharedInstance]];
    }
    else if ([type isEqualToString:@"pay"])
    {//充值
        [LanPlatform pay:[SDKListener sharedInstance]];
    }

这里根据type类型将消息分发到通用SDK层对应的处理模块，再由通用SDK层去调用平台SDK的API进行具体的处理，注意这里传入了一个实例SDKListener，SDKListener负责接送平台SDK的回应，并将数据发送至Unity侧。

通用SDK层的功能

目前包含以下常见的模块：登录，登出，切换账号，充值，用户中心，用户论坛，用户反馈，防沉迷，实名认证。以及各项游戏数据的上报：选服，进入游戏，创建角色，升级等等。

应用生命周期SDK

SDK中比较特殊的一类，基本上也是所有SDK都需要接入的API是生命周期API，本文处理项对比较特殊一点。

@protocol SDKLifeCycleListener <NSObject>
@optional
- (void)didFinishLaunching:(NSNotification*)notification;
- (void)didBecomeActive:(NSNotification*)notification;
- (void)willResignActive:(NSNotification*)notification;
- (void)didEnterBackground:(NSNotification*)notification;
- (void)willEnterForeground:(NSNotification*)notification;
- (void)willTerminate:(NSNotification*)notification;
@end

//注册生命周期回调函数
void SDKRegisterLifeCycleListener(id<SDKLifeCycleListener> obj)
{
#define REGISTER_SELECTOR(sel, notif_name)					\
        if([obj respondsToSelector:sel])							\
            [[NSNotificationCenter defaultCenter] 	addObserver:obj	\
                                                    selector:sel	\
                                                    name:notif_name	\
                                                    object:nil		\
            ];														\

    REGISTER_SELECTOR(@selector(didFinishLaunching:), UIApplicationDidFinishLaunchingNotification);
    REGISTER_SELECTOR(@selector(didBecomeActive:), UIApplicationDidBecomeActiveNotification);
    REGISTER_SELECTOR(@selector(willResignActive:), UIApplicationWillResignActiveNotification);
    REGISTER_SELECTOR(@selector(didEnterBackground:), UIApplicationDidEnterBackgroundNotification);
    REGISTER_SELECTOR(@selector(willEnterForeground:), UIApplicationWillEnterForegroundNotification);
    REGISTER_SELECTOR(@selector(willTerminate:), UIApplicationWillTerminateNotification);
    
#undef REGISTER_SELECTOR
}

这里定义了一个SDK生命周期监听的协议SDKLifeCycleListener, 以及注册该协议的接口SDKRegisterLifeCycleListener。在App加载的时候，将该监听注册进去，实现该协议的也是SDKListener。

@implementation SDKListener

//加载函数，实现在加载该类时，注册生命周期监听函数
+(void)load
{
    NSLog(@"[SDK] load\n");
    SDKRegisterLifeCycleListener([SDKListener sharedInstance]);
}

小结

至此，大概介绍了一下所实现的IOS SDK的方法。简而言之，unity通过CallSDKFunc调用通用SDK功能，通用SDK通过SDKConnector分发消息给具体的通用SDK模块，再由平台SDK处理。SDKListener负责接收平台处理的结果和生命周期事件，并将需要的结果返回给Unity。

就目前的实现来看，能够较好的相对解耦游戏与SDK之间的联系，不会因平台的差异性导致游戏代码的频繁改动。当然目前接入的SDK还相对较少还需测试。