豌豆荚SDK配置说明(网游)
游众 一、接入前的准备
1.豌豆荚网游专区公共邮箱:onlinegames@wandoujia.com,微信:dev-ops
豌豆荚联运网游商务负责人为:洪绯、徐子惠
2.商务在开发者网站:http://developer.wandoujia.com/,(豌豆荚开发者中心的默认浏览器为 Chrome。建议您使用Chrome,避免注册过程发生未知错误。)点击网页右上方的“登陆”按钮。若您已经注册过豌豆荚的账户,直接登陆即可。若您还未注册,请注册一个豌豆荚的账户。注册完毕后页面会自动跳转。
3、登陆账号后,选择右上角的“管理应用”,按要求完善开发者信息。
如果需要修改账号信息,可点击 右上角头像,下拉列表里的“修改注册信息”
4、豌豆荚不直接审核账号,在开发者中心首页,点击“应用”就可以直接提交您的应用/游戏,并完善信息。
「+添加新应用」 – 提交应用,或非联运游戏。不开计费网游
「+联运游戏」 – 提交联运游戏评审。开计费网游
「+接入移动广告」 – 接入网盟广告SDK
上传应用,选择“+添加新应用”
注意事项:豌豆荚要求平台上的游戏包名必须以 .wdj 结尾
5、回调地址的设置:
配置:获取该渠道的游众平台回调地址
使用时请把回调地址中的APPID替换为在游众注册的应用ID,去掉大括号{}和中间的-。
6、完游戏后,点击游戏联运展示界面,查看游戏信息,获取参数AppKeyID、SecretKey:
二、游众工具参数说明
1、AppKeyID(AppKey ID):豌豆荚后台提供,游戏的唯一标识
2、AppSecretKey(Secret Key):豌豆荚后台
3、提供横竖屏:设置登陆和支付界面的横竖屏
三、注意事项
1、豌豆荚sdk登录模块,可用测试账号登录。
测试账号:gametest@wdj.com
密码:123456wdj
2、包名的要求:豌豆荚要求平台上的游戏包名必须以 .wdj 结尾
3、闪屏可以直接在工具中设置:
4、豌豆荚不用设置角标
5、豌豆荚有悬浮窗,请确保onPause、onResume已经调用
6、切换账号的逻辑:在登出回调onLogout里,调用登录接口login
四、常见问题
1、关于渠道SDKID
豌豆荚的渠道SDKID:{B4447B49-BC295EFE}
游众服务器同步回调的SDKID格式为:B4447B49BC295EFE。
2、支付订单后没有收到豌豆荚服务器回调通知的原因:
2.1、配置的URL是否正确,可在开发者后台http://open.wandoujia.com/home/myapp里编辑,会立刻生效。
获取该渠道的游众平台回调地址
使用时请把回调地址中的APPID替换为在游众注册的应用ID,去掉大括号{}和中间的-。
2.2、检查客户端appkey是否正确
2.3、查看游戏服务器的access log
2.4、在开发者后台http://open.wandoujia.com/home/myapp里查询订单详情中的回调时间
2.5、确认以上没有问题后,可以在开发者后台里查询失败订单发起手动回调
3、setdata接口必接接口
上传数据接口需在三处调用,分别为进入服务器(enterServer)、玩家创建用户角色(createRole)、玩家升级(levelUp),有如下三点需注意:
a)游戏中该接口必须调用三次,传入不同的scene_Id,以区分不同的上传数据;
scene_Id的对应值
进入服务器==enterServer、玩家创建角色==createRole、玩家升级==levelUp
注意,请传入对应的值,该参数不为空。
b)若游戏中无对应接口功能,如游戏中无需创建角色,则可根据自身情况在合适位置进行调用,如登录成功后;
c)在上传游戏数据时,若存在无对应字段值的情况,可传入默认值如下:
roleId 当前登录的玩家角色ID,必须为数字,若无,可传入userid
roleName 当前登录的玩家角色名,不能为空,不能为null,若无,传入”游戏名称+username”,如”刀塔传奇风吹来的鱼”
roleLevel 当前登录的玩家角色等级,必须为数字,且不能为0,若无,传入1
zoneId 当前登录的游戏区服ID,必须为数字,且不能为0,若无,传入1
zoneName 当前登录的游戏区服名称,不能为空,不能为null,若无,传入游戏名称+”1区”,如”刀塔传奇1区”
balance 当前用户游戏币余额,必须为数字,若无,传入0
vip 当前用户VIP等级,必须为数字,若无,传入1
partyName 当前用户所属帮派,不能为空,不能为null,若无,传入”无帮派”
示例:
JSONObject
infos= new JSONObject();
try {
infos.put("roleId", "1");
infos.put("roleName", "猎人");
infos.put("roleLevel", "100");
infos.put("zoneId", "1");
infos.put("zoneName", "阿狸一区");
infos.put("balance", "0");
infos.put("vip", "1");
infos.put("partyName", "无帮派");
} catch (JSONException e) {
//TODOAuto-generated catch block
e.printStackTrace();
}
SFOnlineHelper.setData(UserLoginView.this.getActivity(),"enterServer",infos.toString());
SFOnlineHelper.setData(UserLoginView.this.getActivity(),"createrole",infos.toString());
SFOnlineHelper.setData(UserLoginView.this.getActivity(),"levelup",infos.toString());