当前位置:资讯 > 游戏
手游运营中常见的渠道SDK接入事项流程、疑难问题及解决方案
2017-07-13 14:56:18 来源:上方网
渠道SDKCP渠道

由于渠道SDK的特殊性,所以SDK 的 API接口设计至关重要。为什么说SDK开发很特殊呢?因为现在很多的渠道或者平台的SDK,正在使用的游戏、应用多达上千款。任何一个小的调整将直接影响到很多游戏、应用开发者的版本周期。

  SDK前期的API接口设计格外关键

  1、接口名称和参数,一定要清晰

  一个清晰的接口名称可以替代无数的注释。

  2、一个接口只干一件事

  切忌不要把两个没关系的接口合成一个,这样只会增加游戏的接入成本。

  3、接口的数量,尽可能的少

  开发者都希望能够简单快速的接入SDK。

  4、接口的参数,尽可能的少

  如果SDK内部能获取到的,就不要让游戏传递。

  5、SDK的接口中出现的通用名称一定要统一

  不允许前后的接口中,出现2个参数名代表的是同一个字段。比如,APPID和GameID都代表的是应用的ID

  6、按照模块区分使用全局回调(针对手游SDK)

  比如按照必接接口和选接接口进行模块区分,然后分别设置模块的全局回调(一次性注册,而不是每个接口都注册一次)。一方面,游戏开发者在接入渠道SDK的时候,大部分的开发者都是只接入必接接口,这样就不必关心选接接口的回调处理。另一方面,有些特殊情况需要对未调用的接口回调进行处理,如果是全局回调的话,依然可以正常处理游戏逻辑。

  如果您是应用SDK开发,请忽略此原则。

  7、能同步的接口,就不要异步

  开发中碰到的疑难问题及解决方案

  1、接口开发实现中,一定要先对开发者传进来的参数进行校验处理。

  在实际的游戏开发商对接SDK的过程中,有的开发商提交上来的包体,存在一些明显的错误,这或许是因为开发者自身的测试没有太严谨。但一定程度上,说明我们的SDK产品对防范性编程做的不够好。如果我们在最短的路径内发现参数的错误且友好的提示给开发者,这样就可以避免此类问题的出现,能够大大的提升各个环节的效率。

  2、资源文件的命名,采用独立的前缀开头。

  是为了避免与开发者的资源名称重复。比如“close.png”,很多开发者都会用这个名字来命名关闭按钮的图片。建议采用这种命名方式:“ky_hisdk_close.png”,ky代表公司名,hisdk代表产品,close才是寓意的命名。

  3、一定在主线程中传递回调。

  在功能开发中,一些耗时的操作,建议在单独的子线程中进行;但在传递回调的时候,一定要回到主线程。否则,会造成一些UI上的错误。比如某UI页面没有弹出来,很可能是因为没有在UI线程中操作导致的。

  4、SDK开发中用到的第三方库或者框架,不要直接暴露给开发者。

  建议在开发中,对第三方库再封装一层。这样,增加了开发的灵活性,如果库有问题,可以低成本的换其他的。

  建议不要直接将第三方库的返回数据(如错误码等)暴露给开发者,同样的道理,如果这个库出现了问题,将涉及到全部的开发者。

  如果第三方库是开源的,建议你下载源码,根据自己的要求,改变包名,然后再引用。有的时候,会遇到开发者也用到了这个第三方库,但版本不同,可能会造成版本不兼容的问题。这就很尴尬了~

  SDK接入流程

  1、制作裸包

  让研发-客户端技术制作产品裸包,针对账号解决异常问题并预调高级账号供渠道顺利测试。

  如之前对外测试过,玩家已安装过游戏,那么为避免玩家进入渠道测试服,在接入新渠道时最好制作直连渠道测试服的包,好处是无外网IP限制,省略为渠道添加IP白名单的步骤。

  2、提交评测

  填写各渠道的新游接入表、联络表、评测表等,填好后和裸包一并交给我司渠道商务,商务联系各渠道进行评测/评级。

  部分成熟渠道例如360、UC、百度……会对产品评级,用来确认后续合作中的推广资源。评测历时3天左右,期间请保证渠道测试人员能够正常游戏。

  3、拉SDK联调群

  由商务与渠道商务建立讨论组或Q群,并拉齐双方运营、客户端技术、渠道SDK技术支持人员。

  前端技术:在后续接入SDK时有任何技术问题可直接在Q群咨询渠道方SDK技术支持人员即可。

  运营:全程配合商务满足渠道提出的需求。包括渠道后台创建应用、获取参数、提供产品资料、软文、建立专区、论坛、确认上线时间、运营计划、预热活动、发布软文、新闻、发布大事件(UC)、制作并提供礼包、用户服务等等。

  4、获取参数

  4.1渠道后台创建应用获取参数

  向渠道商务要最新的各渠道后台地址、账密。

  运营在各渠道的开发者后台创建应用,即可获取appID、appkey、支付密钥等渠道参数,整理所有渠道参数表,通过邮件发送给平台进行配置,邮件记得抄送给研发前端技术,待平台配置好并回复后研发前端即可在接入产品时使用该参数。

  部分渠道没有后台或创建后无法获得参数,直接在讨论组中向渠道方获取即可。

  一般渠道可直接创建应用获取参数,但部分渠道在创建时就需要安装包、资料等,需准备好后再一同提交创建。

  4.2产品上线所需素材准备

  游戏名称:尽早在各渠道确认是否有重名应用等情况,与市场确定最终游戏名称,尽量避免走改名流程,否则会给各个部门增加不必要的工作量。

  Logo:确定名称后制作相应logo,向美术要大图psd备用。

  申请软著:向商务部提出申请软著的需求,没有软著无法上线。若名称确定沿用可同时申请商标(版号、文网文备案等全套资质带软著申请下来后可继续申请)。

  ICON:事先向研发索要512×512的游戏ICON(最好是PSD格式),由运营向美术发需求添加各渠道角标并批量各种尺寸。

  各渠道所需常用尺寸:36,48,57,72,76,96,114,120,144,152,175,192,512

  宣传图:由于各应用商店上架都必须要游戏宣传图,需要在提包前准备好。

  这期间需要研发提供游戏的美术素材及相关资料,包括绘制高清角色模型等png,运营和市场也要亲自体验游戏并截出大量可用于推广的图,5张宣传图的slogan由运营和市场开会讨论后确认;

  软文:部分渠道创建应用、建立专区、开测上架时需要游戏介绍、一句话描述(20字内)、攻略软文等,由运营负责撰写。同时还需要研发提供一个能对外展示的PPT产品介绍以及word产品说明,运营了解产品后也可自行撰写PPT。

  配置各渠道充值回调地址:运营在渠道后台配置或给渠道配置充值回调地址后才能接通支付。

  安卓:xx

  越狱:xx

  5、平台集成

  如果是公司已合作过的渠道(代表平台已集成过该渠道SDK),运营需要在各渠道开发者后台查看各渠道的SDK是否更新,并在xx检查平台集成的SDK是否为渠道发布的最新版本。

  如果为旧版,需下载渠道开发者平台中的最新版SDK并发邮件给平台进行更新集成。

  如为最新版本,直接让研发的前端技术在xx下载集成好的SDK开始接入产品。

  接入之前,运营应通过邮件告知研发,并倒推、约定好需要最终接完并出包的时间点;

  期间请运营协调好研发前端、平台、渠道技术支持人员的沟通,避免发生在中间传话的现象。

  iOS渠道支持:xx

  安卓渠道支持:xx

  支付SDK支持:xx

  中心服支持:xx

  6、渠道SDK接入及提交测试

  6.1渠道SDK接入和自测调试

  研发-前端技术在xx上获取各渠道的SDK文档进行产品接入。

  SDK文档中除了基础的集成包之外,还包括了渠道SDK的规范文档,部分渠道(尤其是安卓渠道)会在文档里提出各自的要求,请研发技术务必仔细阅读渠道的SDK文档并按照文档要求进行开发。部分渠道的文档里包括开发者自检规范,请研发技术在开发完毕后务必仔细对照规范进行自检。

  各渠道要用规定的包名、icon角标、进游闪屏logo、用户中心、悬浮标等功能需求,以及在plist或manifest.xml中所填的信息需求,请务必符合渠道要求。

  研发接入完SDK务必协调QA部门进行相关测试(部分sdk包中有自测用例,例如UC的,在测试后还需要填写,并在提交包时在后台上传)

  付费方面的测试由QA协助测试,如个别渠道可以申请测试帐号的,运营可以协助申请,技术方面的支持找平台中心负责支付的同事。

  6.2渠道审核

  研发需按事先约定时间制作完渠道SDK最终包,自测后传给运营。最少要在上线前3天以上出包。

  运营提交最终包给渠道审核,如发现问题打回,由运营转达给研发进行修改,直至审核通过。

  由于每次返回修改包后渠道都是从头重启审核流程,因此请研发务必尽快完成修改。

  渠道测试反馈中标明必须修改的地方,研发务必进行修改,否则无法上架。

  渠道审核通过后,由我方约好上架时间,通知研发准备开服。


最热门的手游项目

本周排行 本月排行
永恒传奇
永恒传奇
找联运平台 找渠道阶段:测试
大闹东海
大闹东海
找独代 找联运平台阶段:测试
NO ZUO NO DIE
NO ZUO NO DIE
找独代 找发行商阶段:demo
斗斗城堡
斗斗城堡
找独代 找发行商 阶段:demo
死神嘉年华
死神嘉年华
找独代阶段:demo
吃货棋牌2
吃货棋牌2
找独代 找联运平台阶段:已上线
关于我们使用协议认证

备案:京ICP证041414号-9