TOP

接入渠道SDK游戏开发指南

该指南是综合了目前市场上主流渠道SDK特性后,为游戏开发者提供的游戏设计指南,仔细阅读该指南会有效提高游戏渠道兼容性及渠道上线成功率,降低渠道联调成本。

一、用户模块

1、添加游戏登陆界面


勿在游戏初始化完成后直接调用登陆接口,登陆操作应由用户去触发,当用户点击登陆按钮后才去调用渠道的登陆接口。由于部分渠道初始化时间较长,若由游戏直接调用登陆接口,会导致某些渠道初始化未完成即调用登陆操作,出现登陆异常甚至崩溃。如下图所示:

2、勿在登陆界面做阻塞操作


登陆时需调用 login() 方法,通常情况下渠道在登陆成功或登陆失败时均会产生回调,很多游戏在调用登陆后将界面阻塞,等待成功或失败的回调, 但存在部分渠道在用户取消登陆时(如用户关闭渠道登陆页面)不会向游戏发送回调的,此时游戏将陷入永久的界面阻塞,用户无法再次点击登陆按钮进行登陆,如下图所示:


为了兼容所有渠道,游戏在调用login()方法的同时不要对界面进行阻塞或为阻塞加上超时时间,这样在用户取消登陆但渠道没有发送回调时,游戏可以顺利回到主界面,用户可再次通过手动触发进入游戏按钮再次发起登陆。

3、具备完善的切换帐号(登出)逻辑


渠道要求在游戏运行的任何时刻均可正常登出帐号,所以游戏需要具备完善的登出逻辑,当收到渠道或者游戏自己的切换帐号或登出通知时,能中断游戏逻辑,清空游戏角色信息,返回登陆界面,供用户切换其他帐号登陆。
登出逻辑属于用户系统逻辑,认为随着游戏SDK的不断成熟,未来渠道均会提供切换帐号或登出逻辑。目前有悬浮窗的渠道大部分会在悬浮窗中提供切换帐号功能,但剩余的渠道有部分仍需游戏自己处理,所以强烈建议游戏中添加登出或切换帐号的按钮。

二、支付模块

1、调用支付接口后,勿在游戏界面做阻塞操作


同登陆逻辑,调用支付接口后,切勿在游戏界面做阻塞操作。部分渠道事件处理不完全,如点击支付页面的关闭按钮,没有支付失败的回调;此时返回到游戏,由于没有渠道回调,游戏界面阻塞,玩家将不能继续游戏,影响用户体验。游戏开发商调用支付接口后,不对游戏界面做任何的阻塞操作,当收到支付成功或者支付失败的回调后再执行相关操作。
收到支付失败通知:可文字提示用户
收到支付成功通知:与服务器确认充值状态,按订单状态给游戏玩家发送道具。

2、游戏道具应在游戏服务端发放


当游戏客户端收到渠道客户端的充值成功回调后,请勿直接在客户端做添加道具的操作,应去服务器查询该笔订单状态,服务器验证充值已到账后,再在服务端及客户端进行道具添加。当前的手机网络环境及手机安全性无法保证客户端给出的通知及时有效,渠道给出的支付成功通知均是查询通知,只有渠道在服务端通知到帐后才可进行道具的发放。

三、退出模块

1、添加游戏退出确认窗口


用户在按物理返回键或者退出游戏按钮时,游戏需弹出退出确认窗口,让用户确认是否退出,防止用户误点击导致的游戏退出,提高用户体验。当前渠道的要求有两种,当渠道有自己的渠道退出界面时,游戏不能有自己的退出界面;当渠道没有自己的渠道退出界面时,渠道要求游戏有自己的游戏退出界面。游戏制作商可根据渠道要求进行退出确认窗口的显示。



游戏退出界面如下:


渠道退出界面如下:


游戏上线渠道的速度及质量与游戏的设计实现息息相关,好游戏从设计开始。