CN106445509A - 一种sdk批量快速接入工具 - Google Patents

Abstract

本发明提出一种SDK批量快速接入工具，涉及游戏开发技术领域，所述接入工具通过客户端连接游戏服务器、接入工具服务器及渠道平台服务器，包括用户系统接口、支付系统接口、广告系统接口、统计系统接口、社交系统接口、分享系统接口。本发明的速接入工具，可帮开发者实现只接入一次就能批量打出所有渠道包，并且不再需要关心SDK的版本更新和处理因为渠道服务端接口变化造成的紧急重复更新工作；提供了各个语言版本的框架，开发者只需选择自己熟悉的开发语言即可；大量减少接入时间，根据接入工具的文档操作接入一次，花费的时间跟手工接入一个渠道SDK的时间相同，然后就可以通过接入工具提供的打包工具打出包含了不同SDK的渠道包。

Description

一种SDK批量快速接入工具

技术领域

本发明涉及游戏开发技术领域，尤其是一种SDK批量快速接入工具。

背景技术

SDK的全称是Software Development Kit,中文的意思就是软件开发包。它提供一套有一定结构和逻辑的对外开发接口，封装对内的业务逻辑。开发者只需要按照说明文档使用相应的对外开发接口就可以实现预期的功能，简化了互联网应用开发流程，提高了互联网应用开发速度，并在一定程度上保证了互联网应用的开发质量。

目前国内有大大小小上百家手游渠道，每一个渠道都会要求开发者在游戏中正确接入相应渠道的登录及支付SDK，能让玩家使用在渠道注册的账户来登录游戏，并发起支付在游戏内充值。也就是说只有接入了渠道SDK的游戏才能通过渠道审核并上架。在接入SDK的过程中会有以下一些问题：

1、由于每一家渠道SDK的设计不同，SDK里自带的资源文件，代码jar包，功能接口数量等都是完全不一样；

2、不能在同一份游戏代码中同时嵌入多家SDK的内容，因此开发者必须维护多套游戏代码项目来分别接入各家渠道SDK；

3、服务端的开发者也需要去研究每家渠道设计的不同加密算法及数据校验方式，来开发订单数据校验和用户登录安全认证接口；

4；开发者须手动去写jni函数进行java层代码与C++层代码的双向调用(其他语言同理)，这就要求开发者对java语法和jni规则比较熟悉。

根据数据显示，一个有经验的开发者平均接入一款渠道SDK需要耗费的时间(客户端接入+服务端对接)大概在两天到三天之间，而如果是之前没有接入SDK经验的开发者，这个时间会增加到两倍，因为有很多渠道的特殊需求及“潜规则”需要了解更严重的问题是，当游戏要接入上线的渠道非常多的时候，这个耗费的时间数量会成倍增长，也就是说你接入前一款SDK时候所做的工作并不能减少你接入下一款SDK需要的工作量。

发明内容

本发明提供一种SDK批量快速接入工具，是一款为开发者加速接入第三方SDK的工具，大量减少接入时间。

本发明具体采用如下技术方案实现：

一种SDK批量快速接入工具，所述接入工具通过客户端连接游戏服务器、接入工具服务器及渠道平台服务器，包括用户系统接口、支付系统接口、广告系统接口、统计系统接口、社交系统接口、分享系统接口，所述用户系统接口，用于用户登陆、注销、切换账号、平台中心、显示悬浮按钮、隐藏悬浮按钮、显示退出页及显示暂停页相关渠道功能；所述支付系统接口，用于用户支付、获取订单号；所述广告系统接口，用于显示广告、隐藏广告；所述统计系统接口，用于开始会话、结束会话、设置会话时长、设置是否捕捉异常、异常错误信息报告及自定义事件的统计功能；所述社交系统接口，用于提交分数、显示排行榜、解锁成就、显示成就榜；所述分享系统接口，采用ShareSDK的一键分享，用于分享至社交平台。

作为优选，所述用户系统接口的用户登陆流程包括以下步骤：

步骤11：所述游戏服务器调用登陆接口(向所述渠道平台服务器发起登录请求)；

步骤12：用户登录成功，所述渠道平台服务器返回认证码

步骤13：所述客户端拿着认证码向所述游戏服务器请求登录验证；

步骤14：所述游戏服务器将认证码转发给所述接入工具服务器；

步骤15：所述接入工具服务器向所述渠道平台服务器进行用户登录验证

步骤16：所述接入工具服务器接收验证结果，将结果转发给所述游戏服务器

步骤17：所述游戏服务器通知所述接入工具服务器登录验证结果，所述接入工具回调给游戏服务器是否登陆成功。

作为优选，所述支付系统接口的用户支付流程包括以下步骤：

步骤21：所述游戏服务器调用所述接入工具支付接口请求订单号；

步骤22：所述客户端获取订单号，向所述渠道平台服务器请求支付；

步骤23：支付成功后，所述渠道平台服务器同步通知所述接入工具；

步骤24：所述渠道平台服务器会异步通知所述接入工具服务器；

步骤25：所述接入工具服务器响应所述渠道平台服务器，将支付结果通知到所述游戏服务器；

步骤26：所述游戏服务器响应所述接入工具服务器的支付通知，验证支付通知并发放道具。

本发明提供的SDK批量快速接入工具，其有益效果在于：

1、可以帮开发者实现只接入一次就可以批量打出所有渠道包，并且不再需要关心SDK的版本更新和处理因为渠道服务端接口变化造成的紧急重复更新工作；

2、提供了各个语言版本的框架，开发者只需选择自己熟悉的开发语言即可；

3、大量减少接入时间，根据接入工具的文档操作接入一次，花费的时间跟手工接入一个渠道SDK的时间相同，然后就可以通过接入工具提供的打包工具打出包含了不同SDK的渠道包。

附图说明

图1是本发明SDK批量快速接入工具的接入流程图；

图2是本发明SDK批量快速接入工具的登陆流程图；

图3是本发明SDK批量快速接入工具的支付流程图。

具体实施方式

为进一步说明各实施例，本发明提供有附图。这些附图为本发明揭露内容的一部分，其主要用以说明实施例，并可配合说明书的相关描述来解释实施例的运作原理。配合参考这些内容，本领域普通技术人员应能理解其他可能的实施方式以及本发明的优点。图中的组件并未按比例绘制，而类似的组件符号通常用来表示类似的组件。

现结合附图和具体实施方式对本发明进一步说明。

本实施例提出的SDK批量快速接入工具，通过统一接口实现快速接入，提供了五个不同语言(C++、Java、Lua、Js、Unity)游戏引擎版本的框架供开发者选择自己熟悉的语言版本来集成，不用关心不同语言如何去调用java层的一个函数。

接入工具具体包括AnySDK_Framework(Java)开发包及AnySDK相关参数，AnySDK为申请人内部命名。在AnySDK Framework中，总共有六大类接口——分别是用户，支付，统计，分享，广告和社交。开发者只需要根据自己的需求来调用相应的函数，比如想要打出的渠道包能登录，能支付，并能显示广告。那么就只需要根据AnySDK的文档调用login，payForProduct，showAds等函数，传入相应的参数就可以，真正调用相应SDK函数的工作由AnySDK来完成。

同样的，在服务端，开发者也不用关心某家渠道的文档规定了开发者需要以什么样的加密方式和校验算法来校验渠道服务器推送到游戏服务器的订单数据，开发者需要做的，只是根据AnySDK提供的文档来对接收到的数据做一次安全性校验就可以确认当前订单是来自哪个渠道，是否支付成功等。各渠道间不同的协议和规范由AnySDK去帮开发者完成统一。

接入AnySDK的流程如图1所示，开发者首先将AnySDK framework集成到游戏项目当中，然后直接运行项目，观察是否成功调用了初始化，登录，支付等函数。当开发者直接运行接入了AnySDK framework的项目测试调用相应函数没有问题之后，就意味着接入AnySDKFramework已经成功，这时候运行项目所编译出的APK包称之为“母包”，顾名思义，这个APK包用于生成包含渠道SDK的“渠道包”，“渠道包”就是用于提交给各渠道审核，审核通过之后分发给最终玩家的APK包。简单来说，“母包”就是游戏代码结合AnySDK Framework，“渠道包”就是游戏代码结合AnySDK Framework再结合渠道SDK(包括代码+资源)。

“母包”生成“渠道包”通过以下步骤实现：

1、选择要打包的APK所属的渠道(如百度91，360等)；

2、选择希望在当前渠道的APK包中集成的SDK(比如91渠道，根据渠道要求，要在APK中集成百度游戏的用户和支付SDK)；

3、就是为选择的每一个SDK配置相应的开发者参数(开发者想要使用任何一个SDK都必须先去SDK提供方的网站去申请相应的开发者参数)；

4、选择是否需要添加渠道闪屏(根据渠道要求，目前所有要求添加闪屏的渠道AnySDK都已经提供了闪屏选项，并可以根据渠道的规定来修改游戏icon，添加相应的渠道角标)；

5、点击打包按钮，等待10-20s之后打包工具就会生成渠道包，开发者可以直接点击“安装”按钮将渠道包直接安装在手机上来测试生成的渠道包工作是否正常。

当开发者通过“母包”生成了相应渠道的“渠道包”并通过测试之后，就可以将这些APK包上传到相应的渠道开发者后台来申请渠道审核并上架。如果打出的渠道包在测试过程中发现了某些接口运行结果异常，则需要开发者修改母包中的代码，修复bug之后再重复上面编译打包的过程来生成渠道包，进行再次提交测试。

登陆AnySDK的流程如图2所示，这里分为客户端和服务端开发者需要实现的代码逻辑来讲解。

首先是客户端，在游戏代码中先初始化AnySDK Framework，具体流程如下：

1、当接收到框架初始化成功的回调函数之后直接调用Login函数即可显示出SDK的登录界面；

2、当玩家输入了正确的用户名和密码之后AnySDK就会自动处理后续的登录及用户验证流程；

3、当完成用户登录验证之后就会自动回调到开发者在前一步设置的用户系统监听函数；

4、开发者就可以在登录成功的回调函数中处理后续的游戏逻辑，整个登录过程客户端只需要调用一个接口就可以了。

在服务端需要进行以下步骤：

1、在客户端调用login接口之后AnySDK Framework会请求“登录验证接口地址”(此地址在打包工具中参数配置页面进行配置，而在未经过打包工具的“母包”中，则是请求代码中初始化AnySDK Framework时填入的第三个url参数)；

2、这个接口负责负责将客户端请求过来的所有参数转发给AnySDK服务器(客户端请求过来的参数个数是不确定的，因为每个SDK登录验证需要的参数都是不同的，所以在这个接口中需要遍历解析所有的请求参数，然后全部转发给AnySDK服务器。在AnySDK的文档中已经提供了现成的代码供开发者直接部署使用)去做登录验证；

3、AnySDK服务器会返回登录验证结果，开发者将验证结果的完整数据再返回给客户端就可以了。

上述整个过程是一次HTTP连环请求，即下面这个流程：

客户端——请求——游戏服务器(登录验证接口)——请求——AnySDK服务器(跟渠道服务器交互)——返回——游戏服务器——返回——游戏客户端，是在同一次HTTP请求中完成的。只要客户端的AnySDK Framework回调了登录成功的函数，就说明整个登录验证流程完全走通了。

AnySDK的支付流程如图3所示，在客户端代码中发起一笔订单支付非常简单，只需要调用payForProduct函数，传入玩家当前选择的道具信息，就可以调出SDK支付界面(在母包中则是弹出一个简单的确认支付的对话框)。当玩家在支付界面中完成支付之后即会回调执行开发者设置的支付监听函数。在支付成功的回调函数中，开发者需要跟游戏服务器做通讯确定当前订单是否支付成功。

整个支付过程即是下面这个流程：

客户端：调用支付接口发起支付——接到SDK支付成功回调——去游戏服务器确认支付结果；

服务端：渠道服务器完成扣款流程——推送数据给AnySDK服务器——AnySDK服务器做数据校验，并格式化为统一格式——推送数据给游戏服务器——游戏服务器校验订单数据。

当游戏客户端带着订单号去游戏服务器确认当前订单支付结果是支付成功之后，此时一笔完整的订单支付流程就算走完了，此时就可以根据游戏的逻辑进行游戏内物品的发放。

尽管结合优选实施方案具体展示和介绍了本发明，但所属领域的技术人员应该明白，在不脱离所附权利要求书所限定的本发明的精神和范围内，在形式上和细节上可以对本发明做出各种变化，均为本发明的保护范围。

Claims (3)

1.一种SDK批量快速接入工具，所述接入工具通过客户端连接游戏服务器、接入工具服务器及渠道平台服务器，包括用户系统接口、支付系统接口、广告系统接口、统计系统接口、社交系统接口、分享系统接口，其特征在于，

所述用户系统接口，用于用户登陆、注销、切换账号、平台中心、显示悬浮按钮、隐藏悬浮按钮、显示退出页及显示暂停页相关渠道功能；

所述支付系统接口，用于用户支付、获取订单号；

所述广告系统接口，用于显示广告、隐藏广告；

所述统计系统接口，用于开始会话、结束会话、设置会话时长、设置是否捕捉异常、异常错误信息报告及自定义事件的统计功能；

所述社交系统接口，用于提交分数、显示排行榜、解锁成就、显示成就榜；

所述分享系统接口，采用ShareSDK的一键分享，用于分享至社交平台。

2.根据权利要求1所述的一种SDK批量快速接入工具，其特征在于：所述用户系统接口的用户登陆流程包括以下步骤：

步骤11：所述游戏服务器调用登陆接口(向所述渠道平台服务器发起登录请求)；

步骤12：用户登录成功，所述渠道平台服务器返回认证码

步骤13：所述客户端拿着认证码向所述游戏服务器请求登录验证；

步骤14：所述游戏服务器将认证码转发给所述接入工具服务器；

步骤15：所述接入工具服务器向所述渠道平台服务器进行用户登录验证

步骤16：所述接入工具服务器接收验证结果，将结果转发给所述游戏服务器

步骤17：所述游戏服务器通知所述接入工具服务器登录验证结果，所述接入工具回调给游戏服务器是否登陆成功。

3.根据权利要求1所述的一种SDK批量快速接入工具，其特征在于：所述支付系统接口的用户支付流程包括以下步骤：

步骤21：所述游戏服务器调用所述客户端支付接口请求订单号；

步骤22：所述接入工具获取订单号，向所述渠道平台服务器请求支付；

步骤23：支付成功后，所述渠道平台服务器同步通知所述接入工具；

步骤24：所述渠道平台服务器会异步通知所述接入工具服务器；

步骤25：所述接入工具服务器响应所述渠道平台服务器，将支付结果通知到所述游戏服务器；

步骤26：所述游戏服务器响应所述接入工具服务器的支付通知，验证支付通知并发放道具。