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还相对较少还需测试。