Unity3D 接入IOS SDK

2020-01-07 14:40:07 浏览数 (1)

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层的功能:

代码语言:javascript复制
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

代码语言:javascript复制
//!---------------------------外部接口声明--------------------------------------------
#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接口的声明与定义

代码语言:javascript复制
#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负责消息的分发

代码语言:javascript复制
- (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,本文处理项对比较特殊一点。

代码语言:javascript复制
@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。

代码语言:javascript复制
@implementation SDKListener

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

小结

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

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

0 人点赞