掌盟 SoEasy SDK 开发者帮助文档 1. 接入前项目检查根据游戏接入后出现的问题, 对游戏项目做以下几点要求 : a) AndroidManifest.xml 中 android:targetsdkversion="19" b) 如果 AndroidManifest.xml 有 insta

Size: px

Start display at page:

Download "掌盟 SoEasy SDK 开发者帮助文档 1. 接入前项目检查根据游戏接入后出现的问题, 对游戏项目做以下几点要求 : a) AndroidManifest.xml 中 android:targetsdkversion="19" b) 如果 AndroidManifest.xml 有 insta"

纽沧辈裘
5 years ago
Views:

1 1. 接入前项目检查根据游戏接入后出现的问题, 对游戏项目做以下几点要求 : a) AndroidManifest.xml 中 android:targetsdkversion="19" b) 如果 AndroidManifest.xml 有 installlocation 选项时, 参数设置为 auto c) AndroidManifest.xml 中的 Activity 需要进行如下配置 android:configchanges="keyboardhidden orientation screensize" d) 根据游戏的横竖屏, 将 activity 做横竖屏设置 android:screenorientation="landscape" android:screenorientation="portrait" e) AndroidManifest.xml 中的 Activity 等组件路径为完整路径 2. 接入流程 2.1 添加资源下载 SDK 资源, 将 files 文件夹下的文件 assets libs 和 res 拷贝到项目对应的文件夹中 2.2 修改 AndroidManifest 添加权限 <uses-permission android:name="android.permission.internet"/> <uses-permission android:name="android.permission.access_network_state"/> <uses-permission android:name="android.permission.read_phone_state"/> <uses-permission android:name="android.permission.write_external_storage"/> 添加 Application 在 AndroidManifest.xml 中的 Application 节点, 修改 android:name 属性值为 com.zmapp.mzsdk.mzapplication 如果游戏有自己的 Application 需求, 需要在 Application 的生命周期方法中做一些操作可以实现 IApplicationListener 里面的接口添加 meta-data <meta-data android:name="mz_app_id" android:value=" 联系商务 ( 不填或者错误无法获取登陆信息 )" /> 2.3 生命周期处理 protected void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); com.zmapp.mzsdk.mzsdk.getinstance().oncreate(); protected void onstart() { super.onstart(); com.zmapp.mzsdk.mzsdk.getinstance().onstart();

2 protected void onrestart() { super.onrestart(); com.zmapp.mzsdk.mzsdk.getinstance().onrestart(); protected void onpause() { super.onpause(); com.zmapp.mzsdk.mzsdk.getinstance().onpause(); protected void onresume() { super.onresume(); com.zmapp.mzsdk.mzsdk.getinstance().onresume(); protected void onstop() { super.onstop(); com.zmapp.mzsdk.mzsdk.getinstance().onstop(); protected void ondestroy() { super.ondestroy(); com.zmapp.mzsdk.mzsdk.getinstance().ondestroy(); protected void onnewintent(intent intent) { super.onnewintent(intent); com.zmapp.mzsdk.mzsdk.getinstance().onnewintent(intent); protected void onactivityresult(int requestcode, int resultcode, Intent data) { super.onactivityresult(requestcode, resultcode, data); com.zmapp.mzsdk.mzsdk.getinstance().onactivityresult(this, requestcode, resultcode, data); 2.4 SDK 初始化设置设置初始化回调接口 MZSDK.getInstance().setSDKInitListener(new IMZSDKInitListener() { public void oninitsuccess(final InitResult result) { public void oninitfail(final int code, final String msg) {

3 //code: 初始化失败错误码,msg: 初始化失败错误信息 ); 设置用户回调接口 MZSDK.getInstance().setSDKUserListener(new IMZSDKUserListener() { public void onloginfail(final int code, final String msg) { //code: 登录失败错误码,msg: 登录失败错误信息 public void onloginsuccess(final String userinfojsonstr) { // 登录成功,userInfoJSonStr 参数说明参照下面表格 public void onswitchaccount() { public void onswitchaccount(final String userinfojsonstr) { // 切换账号成功,userInfoJSonStr 参数说明参照下面表格 public void onlogout() { ); userinfojsonstr 是返回的用户信息, 是 JSON 字符串格式 : status 0 表示成功获取到了用户信息, 其它值都为失败 userdata uid t sign 用户唯一码时间戳, 数字字符串校验方法是 :sign=md5(secret_key=1&t=2&uid=3), 参数首字母升序排列,md5 是 32 小写设置支付回调接口 MZSDK.getInstance().setSDKPayListener(new IMZSDKPayListener() { public void onpaysuccess(final PayResult result) { // 支付成功 // 道具计费点编号 : result.getproductid() // 道具名称 : result.getproductname() // 透传字符串 :result.getextension() public void onpayfail(final int code, final String msg) {

4 //code: 支付失败错误码,msg: 支付失败错误信息 ); 接入要求 : 客户端的支付回调仅作为通知使用, 以服务端的支付回调为最终发货依据 2.5 SDK 接口调用接入要求 :SDK 的接口需在 UI 主线程下调用 SDK 初始化类名 :com.zmapp.mzsdk.mzsdk 方法 :public void init(activity activity) 功能 : 渠道 SDK 初始化参数 :activity 必填当前 Activity 案例 : com.zmapp.mzsdk.mzsdk.getinstance().init(activity); 接入要求 : 初始化接口, 应在 Activity 中 oncreate 方法中调用登录方法 :public void login() 功能 : 渠道 SDK 登录案例 : com.zmapp.mzsdk.mzuser.getinstance().login(); 支付类名 :com.zmapp.mzsdk.mzpay 方法 :public void pay() 功能 : 渠道 SDK 支付参数 :params 必填订单信息案例 : PayParams params = new PayParams(); params.setproductid("1");//productid params.setproductname(" 道具 1");//productName params.setproductdesc(" 道具 1 的描述 ");//productdesc params.setprice(100);//price params.setratio(1);//ratio params.setservername(" 服务器 1");//serverName params.setserverid("123");// 数字字符串 params.setroleid("123456");// 数字字符串 params.setrolename(" 速易大侠 ");// 角色名称 params.setrolelevel(100);// 角色等级 params.setvip("0");// 默认值是 0 params.setextension(" 透传参数 "); params.setcheck(" 服务端生成签名 "); MZPay.getInstance().pay(params); 支付信息参数 PayParams 的格式说明 : 字段类型是否必填说明

5 productid String 是道具计费点编号, 数字字符串 productname String 是道具名称 productdesc String 否道具描述 price int 是道具价格, 单位为分 servername String 是服务器名称 serverid String 是服务器编号, 数字字符串 roleid String 是角色编号, 数字字符串 rolename String 是角色名称 rolelevel int 否角色等级 VIP String 否角色 VIP 等级 extension String 否透传字符串, 支付回调会原样返回给游戏 check String 是 check=md5(fee+feeid+seceret_key), 其中 md5 为小写, + 不参与加密注意加密必须在服务端完成 check 生成示例 :fee=600, feeid=123,secret_key=abcde123456,check =31a482a2b53dde3bdb30815b6af79b 注销方法 :public void logout() 功能 : 渠道 SDK 登录案例 : com.zmapp.mzsdk.mzuser.getinstance().logout(); 退出方法 :public void exit() 功能 : 渠道 SDK 退出案例 : MZPay.getInstance().pay(params); if (MZUser.getInstance().isSupport("exit")) { MZSDK.getInstance().runOnMainThread(new Runnable() { public void run() { MZUser.getInstance().exit(); ); else { // 游戏自己的退出确认框角色信息上报方法 :public void exit()

6 功能 : 渠道 SDK 角色信息上报案例 : UserExtraData extradata = new UserExtraData(); extradata.setdatatype(1); extradata.setserverid(10); extradata.setservername("server_10"); extradata.setroleid("role_100"); extradata.setrolename("test_112"); extradata.setrolelevel("10"); extradata.setmoneynum(100); extradata.setpartyname(" 帮派 "); extradata.setrolectime(" "); extradata.setrolelevelmtime(" "); MZUser.getInstance().submitExtraData(extraData); 角色信息参数表 : UserExtraData 字段类型是否必填说明 datatype int 是 1. 选择服务器 2. 创建角色 3. 进入游戏 4. 等级提升 5. 退出游戏 serverid int 是服务器 ID servername String 是服务器名称 roleid String 是角色 ID rolename String 是角色名称 rolelevel String 是角色等级 fightvalue String 是战力值 moneynum int 否游戏币 partyname String 否所在帮派名称 rolecreatetime String 否角色创建时间,10 位整数字符串, 秒为单位, 格式参照 rolelevelmtime String 否角色升级时间,10 位整数字符串, 秒为单位, 格式参照 gender String 否角色性别, 可传男女无 professionid 否职业 ID profession String 否职业名称 VIP 否 VIP 等级 partyid 否所在帮派 ID partyname String 否所在帮派名称 partyroleid 否帮派称号 id partyrolename String 否帮派称号名称 friendlist String 否角色相互关系, 例如 [{"roleid": " 关系角色 id","intimacy": " 亲密度 ", "nexusid": " 关系 id, 可填数字 1: 夫妻 2: 结拜 3: 情侣 4: 师徒 5: 仇人 6: 其它 " ] 接入要求 : SDK 会根据渠道不同进行上报, 渠道存在不上报不给上线情况, 如果个别参数没有传空值, 建议都传值

7 3. 其它 3.1 关于混淆 SDK 已经经过了混淆, 如果要混淆 java 代码, 请不要混淆联编的 jar 包中的类可以添加以下类到 proguard 配置, 排除在混淆之外 : -keep class com.zmapp.** { *;

梦工厂 SDK 安卓网游对接文档 V1.0 版本号时间变更内容初始化版本

梦工厂 SDK 安卓网游对接文档 V1.0 版本号时间变更内容 1.0 2015-06-01 初始化版本目录接入说明... 3 1.1 谁来阅读此文档... 3 1.2 注意事项... 3 1.3 名词定义... 3 2 导入和配置 sdk... 3 2.1 导入配置 sdk... 3 2.2 总体说明... 4 2.3 获取参数... 4 2.4 获取对接 demo... 4 2.5. 导入配置

掌盟 SoEasy SDK 开发者帮助文档 1. 接入前项目检查 根据游戏接入后出现的问题, 对游戏项目做以下几点要求 : a) AndroidManifest.xml 中 android:targetsdkversion="19" b) 如果 AndroidManifest.xml 有 insta

掌盟 SoEasy SDK 开发者帮助文档 1. 接入前项目检查根据游戏接入后出现的问题, 对游戏项目做以下几点要求 : a) AndroidManifest.xml 中 android:targetsdkversion="19" b) 如果 AndroidManifest.xml 有 insta