各版本SDK&接入文档
名称 版本号 发布时间 资源下载 本期更新说明
Android网游SDK V3.2.0 2015-06-15 BDGameSDK_V3.2.0(20150615)_For_Android.rar

文件大小:0.0 MB

接入前务必联系商务接口人确认!!!

从2014年12月10日起,所有新建和更新的游戏必须接入V3.0.0及以上版本SDK,否则无法通过审核

1、新增“充值返利”功能;
2、加强登录功能稳定性;
3、优化多酷/91账号升级流程”
4、部分BUG修复。

Android网游SDK V2.0.1 2014-08-15 BDGameSDK_V2.0.1_2014.08.15.rar

文件大小:0.0 MB

1. 兼容百度、多酷、91三方账号登录;
2. 增加快速试玩功能;
3. 增加百度钱包支付方式;
4. 增加消息、礼包、论坛模块;
5. 优化UI设计,使用百度标志品牌;
6. 增加百度钱包充值返送活动。

Android网游SDK V1.3.1 2014-06-19 DKSDK_V1.3.1_2014.06.19.rar

文件大小:0.0 MB

1.优化SDK,提升稳定性;
2.合并接口,提高CP接入效率;
3.增加一键支付、MO9信用支付功能;
4.优化注册/登录,增加同步登录功能。

接入流程FAQ

1、更新问题

1.1、游戏APK更新机制

游戏需要有自己的更新机制,强制更新时百度游戏只提供给CP测试通过的签名包,CP把签名包放在自己游戏服务器端供老玩家更新下载。同时百度游戏会把更新包上架供新玩家下载。

1.2、百度游戏SDK需要导整个项目,是不是导入资源有特别的要求或者限制?

无特别要求,导入Duoku_Sdk_Project工程并配置AndroidManifest.xml文件即可,详情请参考《百度游戏SDK(支付版)接入API参考手册》。

2、初始化问题

2.1、初始化报错?

初始化要求必须在主Activity的oncreat中进行,初始化代码要在主线程中进行,不要单起子线程调用。

2.2、初始化时是否不用配置App_secret?

是的,客户端无需配置App_secret以防止泄露。此参数用于服务端查询支付购买结果。

3、悬浮窗问题

3.1、登陆后没有出现悬浮窗?

SDK登陆后自动显示悬浮窗,若无悬浮窗请检查AndroidManifest.xml文件是否配置正确,详细请参考百度游戏demo。

查看AndroidManifest.xml文件中是否缺少此句代码:

service android:name="com.duoku.platform.service.DKSuspensionService" /。

3.2、悬浮窗内专区加载失败?非本游戏专区?

1)把AndroidManifest.xml文件中android:targetSdkVersion此参数改为16(不包含16)以下即可。

2)游戏上线后会自动更改为CP专区,需CP端在开发者平台填写。

开发者平台地址:http://dev.mgame.baidu.com/

登陆我的游戏点击产品名称资讯/攻略添加资讯攻略。

3.3、点击切换账号但仍在游戏中?

点击切换账号要求返回登陆界面或者重启游戏(不要在回调里调用我们登陆接口),SDK提供切换账号回调,请CP在回调中做处理,悬浮窗口消失说明回调已成功。

3.4、讲解网游SDK修改密码。

1)操作流程:悬浮窗口——账号管理——修改密码 。

注:第三方登陆时可显示修改密码选项但点击无效。

2)修改密码成功:

修改密码成功后可继续进行游戏,当点击账号管理或者充值操作时会弹出登陆状态失效的窗口。

注:对于appid和appkey未入库(即首次接入SDK)的游戏,不会弹出登陆状态失效的提示,但失效的回调必须要做正确处理,测试请使用多酷账号,百度账号与91账号均不触发此回调,如3)。

3)点击确定按钮:

点击确定按钮后的逻辑操作交给CP处理,此处逻辑与切换账号一致,即返回登陆界面或重启游戏(不要在回调里调用我们登陆接口)。

登陆状态失效回调代码:

4、登陆问题

4001.接入后进行登录/注册/支付,报错或提示“网络数据解析异常,请稍候重试!”?

1)请检查下AndroidManifest.xml文件中的versionName字段,如果以引用字符串资源的形式配置的(通常出现在ANE项目中),请改为直接配置,即写死版本号的方法配置。

2)请检查下AndroidManifest.xml文件中的渠道号是否配置正确 。

注 :渠道号要放到application里 。渠道号13744直接复制即可。

3)请检查是否初始化,appid、 appkey 是否正确,可以把游戏的参数复制到demo中测试。

4)请检查AndroidManifest.xml文件配置中所有activity的横竖屏方向是否与初始化横竖屏方向一致,以确保屏幕方向一致。

5)请检查AndroidManifest.xml文件配置中versionname 和versioncode 是否为固定值,切勿为引用。

注:为了准确检查出问题,以上方法更改后,必须卸载手机原程序并清除缓存重新安装测试。

4.2、第三方登陆异常(百度账号/新浪微博)

1)先查看百度游戏登录注册是否正常?若不正常请参考4.1。

2)导入工程缺包导致,请参考demo仔细检查是否少JAR包。

3)请参考5014条检查.so包是否缺失和存放位置。

4)检查SDK版本是否为线上最新版本。http://dev.mgame.baidu.com/yyjr/sdk

4.3、手机号一键注册异常

1)查看百度游戏注册登陆是否正常;若百度游戏注册登陆不正常请先按4001方法解决。

2)查看手机是否有卡、是否欠费。

4.4、登录返回的sessionId多久过期?如何测试?

session 30天失效,可在另一设备上登录同一账号测试session失效问题。

session失效回调代码如下图,CP必须做正确处理。

5、支付问题

5.1、支付界面进不去,或者停在二级界面无法跳转并且无法支付成功或支付提示网络异常?

1)请检查下AndroidManifest.xml文件中是否配置了渠道号。

即meta-data android:name="DUOKUSDK_CHANNEL" android:value="700" /字段。

2)请先确认是否在登录状态下。

3)对照demo中代码查看支付接口参数。

注:支付描述参数会原样返回,切勿传null、空串、空格。

5.2、从支付界面返回是否有回调?

注:此处mStateCode为true只代表有充值行为,充值结果由百度游戏服务器发送到CP配置的回调地址。

更多通知详见文档《百度游戏SDK(支付版)接入API参考手册》以及demo。

5.3、支付购买结果通知,是POST方式还是GET方式发送到支付回调地址?提交充值用POST还是GET?如果有分区服务是否配置多个回调地址?

1)GET方式。

2)POST方式。

3) 通知里的aid可用于游戏分区,可以不同的分区传不同的aid,处理通知时加以区分,

如果分新的回调地址需要重新分配appkey,appsecret,appid,重新申请一个应用比较麻烦。

5.4、如何配置回调地址?

回调地址配置路线图 http://dev.mgame.baidu.com/

1)登陆开发者专区点击产品名称游戏基本信息。

2)编辑编辑完成后点击保存即可。

可更改,修改后30分钟可测。

5.5、充值是否有测试帐户和虚拟币?

目前测试都是用实卡实测的。充值金额至少1元。

5.6、充值时,充值卡充值中选项移动/电信/联通不全?是否有充值记录接口?酷币与人民币的兑换比例是多少?

1)如果定额充值, 会根据金额来显示充值卡,没有显示的运营商是因为没有对应金额的卡。

2)目前没有,下一版本会增加充值记录。

3)1酷币=1人民币。

5.7、关于假充值充值成功问题?

即随意输入任意卡号和密码都会充值成功。假充值百度游戏会通知result=2,可检查充值逻辑是否有问题。

5.8、支付结果通知的响应状态?

1)百度游戏发起的充值结果通知,CP必须直接以大写字符串的形式返回以上内容之一。

2)通知结果result为2时,只要参数合法,必须返回SUCCESS,表示成功收到'充值失败'的通。

3)如果响应不为SUCCESS、ERROR_REPEAT、ERROR_SIGN三者之一,百度游戏将重发通知。

5.9、登陆验证的uid是否是唯一的?充值回调接口中 orderid由谁生成?CP接收到的数据是encode过的,是否需要decode之后参与签名计算?

1)唯一标示,不同账号不一样。

2)CP客户端生成的。

3)不用,只encode一次是为了传输,比较的时候可以把aid转码之后进行对比。

5.10、加密时参数是否按照英文字母顺序排序?error_code ,error_msg 的类型是什么?timetamp这个参数是毫米还是秒?CP是否需要判断时间戳是否超时?

1)不是英文字母顺序,是文档里写的顺序。

2)error_code是int,error_msg是String 。

3)是标准Unix时间秒。

4)不需要 。

5.11、Uid是否是32位的整数?

后端生成的uid都是64位 ,但传出去的是string,uid是字符串进字符串出,目前最大的id是167388777。

5.12支付类型为0代表什么?

支付类型为0代表酷币余额兑换,具体类型参考SDK中《百度游戏开发平台服务端与应用服务端开发规范-简版》。

5.13、支付成功后获得游戏币显示异常?

正确配置虚拟币信息

名称:金币、砖石、元宝等(此项为虚拟币名称、切勿填写游戏名称)。

汇率:1人民币=100虚拟币(比例为人民币与虚拟币的比例,由CP填写)。

图标:为游戏图标。

5.14、接入网游SDK银联支付黑屏?

1).so包位置不对,反编译后检查工程下是否存在.so包,若没有请参考demo中.so包位置手动加入。

2)打开银联卡jar包,把.bin文件放入反编译后的工程drawable下。

5.15、百度钱包黑屏/卡屏/等待时间长问题

解决方法一:详细比照游戏代码与SDK,确保Activity初始化和AndroidManifest中设置横竖屏的代码无误。

解决方法二:将targetSdkVersion 改为12及以下解决问题。

解决方法三:在AndroidManifest中将所有Activity 设置android:configChanges="keyboardHidden|orientation|screenSize"解决问题。

6、针对不同游戏框架接入SDK黑屏/闪退问题

1)退出游戏不完全。

2)切换账号回调代码处理逻辑有问题。

3)调配主Activity启动模式。(singleTask或singleTop)

4)用空Activity承载初始化代码。

5)对于cocos2d-x开发,调用接口返回的时候比较容易卡机黑屏,如何解决?(应该是切换activity时,gl的纹理被释放然后返回重新加载导致)

参考解决办法:

1)CP的activity 添加android:configChanges="orientation|keyboardHidden|navigation"

2)用空的activity调用sdk的接口,不在游戏的activity中直接调用。

3)把cocos2d-x Cocos2dxGLSurfaceView这个类里的super.onPause;和super.onResume;注释掉。

注意:请在游戏主Activity的onDestory中调用sdk释放资源的方法,以防发生crash,详细请参考Demo中UserLoginActivity的onDestory方法。

7、开发者论坛

1)有问题请先参考论坛,避免不必要的沟通

http://bbs.mgame.baidu.com/

8、SDK界面显示问题

1)显示百度游戏ICON角标和闪屏画面,如图:

注:闪屏界面要求2-3秒,若游戏自带闪屏,百度游戏闪屏优先显示(也可合成一张同屏显示,美观即可),桌面快捷图标要求有百度角标(角标可放在图标四角任意角,根据游戏自身icon调整至最佳位置即可)。

2)登陆成功后要显示悬浮窗口,若不显示请参考3001条。

3)点击充值需弹出百度游戏支付界面,若不弹出请参考5001条。