文档中心 | 一键联接，全心服务

更新日期：2025年 01月 23日Java（Android）接入文档

<h3> 1.接入前项目检查（必接） </h3> 根据游戏接入后出现的问题，QuickSDK对游戏项目做以下几点要求： · AndroidManifest.xml中android:targetSdkVersion="26" (<a href="https://www.quicksdk.com/doc-773.html?cid=9" target="_blank">关于一些应用市场对Android应用API(targetSdkVersion)最低要求的提示</a>) 部分渠道targetVersion为28时9.0设备http请求失败 application节点下添加 <pre class="brush:js;toolbar:false">android:usesCleartextTraffic="true" </pre> 防止游戏与渠道sdk发生横竖屏切换出现问题 · U3D游戏项目下，AndroidManifest.xml中 <pre class="brush:js;toolbar:false"><meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true"></meta-data></pre> Android:value值设置为true · 为Activity添加横竖屏设置 根据游戏的横竖屏，将activity做横竖屏设置 <pre class="brush:js;toolbar:false">android:screenOrientation="sensorLandscape" android:screenOrientation="sensorPortrait"</pre> 或者 <pre class="brush:js;toolbar:false">android:screenOrientation="landscape" android:screenOrientation="portrait"</pre> · AndroidManifest.xml中的Activity等组件路径为完整路径 · 游戏项目的类路径不要使用“com.quicksdk”，打渠道包时会删除该路径下的所有内容。 <h3> 2.接入流程 </h3> <h4> 2.1 添加资源（必接） </h4> 去下载中心下载QuickSDK资源，将files文件夹下的文件libs和res拷贝到项目对应的文件夹中。 <h4> 2.2 添加权限（必接） </h4> Androidmanifest.xml中添加权限（QuickSDK没有要求任何权限，游戏按自己的需要进行添加便可） <pre class="brush:js;toolbar:false"><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission> <uses-permission android:name="android.permission.INTERNET"></uses-permission> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"></uses-permission></pre> <h4> 2.3 添加QuickSdkApplication </h4> 2.3.1  新建游戏的Application（必接） 新建游戏的Application，继承自QuickSdkApplication <pre class="brush:js;toolbar:false">public class GameApplication extends QuickSdkApplication { @Override public void onCreate() { super.onCreate(); } }</pre> 2.3.2  将Application添加到AndroidManifest.xml中（必接） <pre class="brush:xml;toolbar:false"><application android:name="com.quicksdk.test.MyApplication" android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" > </application></pre> 在AndroidManifest.xml中的Application节点，修改android:name属性，其值为游戏新建的Application的全路径 <h4> 2.4 添加闪屏 </h4> 2.4.1  新建游戏闪屏Activity（必接） 新建游戏闪屏Activity，继承自QuickSdkSplashActivity <pre class="brush:js;toolbar:false">public class SplashActivity extends QuickSdkSplashActivity { @Override public int getBackgroundColor() { return Color.WHITE; } @Override public void onSplashStop() { //闪屏结束后，跳转到游戏界面 Intent intent = new Intent(this, MainActivity.class); startActivity(intent); this.finish(); } }</pre> 2.4.2  将闪屏Activity添加到AndroidManifest.xml中,并且设置为游戏启动Activity <pre class="brush:js;toolbar:false"><activity android:name="com.quicksdk.test.SplashActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </pre> 说明： android:name属性，其值为游戏自定义的闪屏Activity全路径 android:screenOrientation属性，其值根据游戏需求决定是横屏还是竖屏 <h4> 2.5 生命周期处理（必接） </h4> 游戏Activity的生命周期，调用相应的方法 <pre class="brush:js;toolbar:false">@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); com.quicksdk.Sdk.getInstance().onCreate(this); } @Override protected void onStart() { super.onStart(); com.quicksdk.Sdk.getInstance().onStart(this); } @Override protected void onRestart() { super.onRestart(); com.quicksdk.Sdk.getInstance().onRestart(this); } @Override protected void onPause() { super.onPause(); com.quicksdk.Sdk.getInstance().onPause(this); } @Override protected void onResume() { super.onResume(); com.quicksdk.Sdk.getInstance().onResume(this); } @Override protected void onStop() { super.onStop(); com.quicksdk.Sdk.getInstance().onStop(this); } @Override protected void onDestroy() { super.onDestroy(); com.quicksdk.Sdk.getInstance().onDestroy(this); } @Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); com.quicksdk.Sdk.getInstance().onNewIntent(intent); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); com.quicksdk.Sdk.getInstance().onActivityResult(this, requestCode, resultCode, data); }</pre> <h4> 2.6 QuickSDK初始化设置 </h4> 2.6.1  设置初始化通知（必接） 类名：QuickSDK 方法：public QuickSDK setInitNotifier(InitNotifier notifier) 功能：设置初始化结果回调通知，一般在游戏开始前，初始化成功后，进行游戏登陆等相关的处理。 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setInitNotifier(new InitNotifier() { @Override public void onSuccess() { //初始化成功 } @Override public void onFailed(String message, String trace) { //初始化失败 } });</pre> 2.6.2  设置登录通知（必接） 类名：QuickSDK 方法：public QuickSDK setLoginNotifier(LoginNotifier notifier) 功能：设置用户登陆结果回调通知的相关处理。 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setLoginNotifier(new LoginNotifier() { @Override public void onSuccess(UserInfo userInfo) { //登录成功，获取到用户信息userInfo //通过userInfo中的UID、token做服务器登录认证 } @Override public void onCancel() { //登录取消 } @Override public void onFailed(final String message, String trace) { //登录失败 } });</pre> 登录信息： UserInfo <table bordercolor="#000000" style="width:50%;" border="1" cellspacing="0" cellpadding="2"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> UID </td> <td> String </td> <td> 用户ID，SDK返回的唯一ID </td> </tr> <tr> <td> username </td> <td> String </td> <td> 用户登录名 </td> </tr> <tr> <td> token </td> <td> String </td> <td> 用户验证token </td> </tr> </tbody> </table> 接入要求： 1）启动游戏，在登录界面中获取到登录成功的通知，跳转到进入游戏的界面； 2）游戏以自动登录的方式调用登录时，获取到登录失败和登录取消的通知，应再次调用登录的功能； 3）不同渠道可能返回相同的UID，游戏应使用渠道ID+UID作为用户的唯一标识。渠道ID通过“public int getChannelType()”获取。 2.6.3  设置注销通知（必接） 类名：QuickSDK 方法：public QuickSDK setLogoutNotifier(LogoutNotifier notifier) 功能：设置用户注销结果回调通知等相关的处理。 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setLogoutNotifier(new LogoutNotifier() { @Override public void onSuccess() { //注销成功 } @Override public void onFailed(String message, String trace) { //注销失败，不做处理 } });</pre> 接入要求：获取到注销成功的通知，游戏应回到登录界面并重新调用登录方法。 2.6.4  设置切换账号通知（必接） 类名：QuickSDK 方法：public QuickSDK setSwitchAccountNotifier(SwitchAccountNotifier notifier) 功能：一些渠道（如：百度 等）在悬浮框有切换账号的功能，此回调即切换成功后的回调。游戏应清除当前的游戏角色信息。在切换账号成功后回到选择服务器界面，用回调结果里面的新的UID 和Token 进入游戏。注意：在此回调内无需调用登录接口 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setSwitchAccountNotifier(new SwitchAccountNotifier() { @Override public void onSuccess(UserInfo userInfo) { //切换账号成功的回调，返回新账号的userInfo } @Override public void onCancel() { //切换账号取消 } @Override public void onFailed(String message, String trace) { //切换账号失败 } })</pre> 切换账号成功信息： UserInfo <table bordercolor="#000000" style="width:50%;" border="1" cellspacing="0" cellpadding="2"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> UID </td> <td> String </td> <td> 用户ID,SDK返回的唯一ID </td> </tr> <tr> <td> username </td> <td> String </td> <td> 用户登录名 </td> </tr> <tr> <td> token </td> <td> String </td> <td> 用户验证token </td> </tr> </tbody> </table> 接入要求： 在游戏界面中，获取到切换账号成功的通知，游戏注销当前的游戏角色，使用新的用户信息，回到进入游戏的界面。（针对渠道SDK在游戏界面中通过悬浮框进行账号的切换） 2.6.5  设置定额支付通知（必接） 类名：QuickSDK 方法：public QuickSDK setPayNotifier(PayNotifier notifier) 功能：设置用户支付结果回调通知等相关的处理 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setPayNotifier(new PayNotifier() { @Override public void onSuccess(String sdkOrderID, String cpOrderID, String extrasParams) { //支付成功 //sdkOrderID:quick订单号 cpOrderID：游戏订单号 } @Override public void onCancel(String cpOrderID) { //支付取消 } @Override public void onFailed(String cpOrderID, String message, String trace) { //支付失败 } });</pre> 说明：游戏充值是否成功到账，只能以服务器的通知为准，而不是客户端的通知，因为部分渠道SDK自身有时不会发送正确的通知。 2.6.6  设置退出通知（必接） 类名：QuickSDK 方法：public  QuickSDK  setExitNotifier(ExitNotifier notifier) 功能：设置用户退出结果回调通知等相关的处理 案例： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setExitNotifier(new ExitNotifier() { @Override public void onSuccess() { //退出成功，游戏在此做自身的退出逻辑处理 } @Override public void onFailed(String message, String trace) { //退出失败，不做处理 } });</pre> 接入要求：获取到退出成功的通知后，游戏做自身的退出逻辑处理。 <h4> 2.7 渠道SDK接口调用 </h4> 接入要求：SDK的接口需在UI主线程下调用 2.7.1   SDK初始化（必接） 类名：com.quicksdk.Sdk 方法：public void init(Activity activity, String productCode, String productKey) 功能：渠道SDK初始化 参数：activity  必填当前Activity targetVersion大于等于23时，需要在初始化之前申请权限（QuickSDK没有要求任何权限，游戏按自己的需要进行申请便可，如不用可以不做申请）如下： 案例1（当targetVersion 较大时  动态申请读写权限和读取手机状态等权限，具体权限具体而定）： <pre class="brush:js;toolbar:false"> try { //check权限 if ((ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) || (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED)) { //没有,申请权限权限数组 ActivityCompat.requestPermissions(MainActivity.this, new String[] { Manifest.permission.READ_PHONE_STATE ,Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUESTCODE); } else { // 有则执行初始化 Sdk.getInstance().init(this, "Product_Code", "Product_Key"); } } catch (Exception e) { //异常继续申请 ActivityCompat.requestPermissions(MainActivity.this, new String[] { Manifest.permission.READ_PHONE_STATE ,Manifest.permission.WRITE_EXTERNAL_STORAGE }, REQUESTCODE); } } @Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { //如果requestCode不是游戏自己申请时传的，则不作处理 if (requestCode != REQUESTCODE){ return; } if (grantResults[0] == PackageManager.PERMISSION_GRANTED) { //申请成功 Sdk.getInstance().init(this,"Product_Code", "Product_Key"); } else { //失败这里逻辑以游戏为准这里只是模拟申请失败 cp方可改为继续正常初始化调登录然后进游戏或者继续申请权限或者退出游戏或者其他逻辑 Sdk.getInstance().init(this,"Product_Code", "Product_Key"); } }</pre> targetVersion小于等于22时，无申请权限。如下： 案例2： <pre class="brush:js;toolbar:false">QuickSDK.getInstance().setInitNotifier(new InitNotifier() { @Override public void onSuccess() { //初始化成功 } @Override public void onFailed(String message, String trace) { //初始化失败 } });</pre> productCode 必填 QuickSDK后台申请的productCode productKey 必填 QuickSDK后台申请的productKey 案例： <pre class="brush:js;toolbar:false">com.quicksdk.Sdk.getInstance().init(activity, "后台申请的productCode", "后台申请的productKey");</pre> 接入要求：初始化接口，应在Activity中onCreate方法中调用。 2.7.2  登录账号（必接） 类名：com.quicksdk.User 方法：public void login(Activity activity) 功能：调用渠道SDK登录 参数：activity 必填当前Activity 案例： <pre class="brush:js;toolbar:false">User.getInstance().login(activity);</pre> 接入要求：进入到登录界面，自动调用此接口，须保证初始化成功后再调用登录接口。 2.7.3  上传角色信息（必接） 类名：com.quicksdk.User 方法：public void setGameRoleInfo(Activity activity, GameRoleInfo roleInfo, boolean createRole) 功能：向渠道SDK上传角色信息 参数：activity 必填当前Activity roleInfo 必填角色信息 createRole 必填是否创建角色 案例： <pre class="brush:js;toolbar:false">//注：GameRoleInfo的字段，以下所有参数必须传，没有的请模拟一个参数传入; GameRoleInfo roleInfo = new GameRoleInfo(); roleInfo.setServerID("1");//数字字符串，不能含有中文字符 roleInfo.setServerName("服务器1"); roleInfo.setGameRoleName("石头"); roleInfo.setGameRoleID("1121121"); roleInfo.setGameBalance("5000"); roleInfo.setVipLevel("4"); &emsp;//设置当前用户vip等级，必须为数字整型字符串,请勿传"vip1"等类似字符串 roleInfo.setGameUserLevel("12");&emsp;//设置游戏角色等级 roleInfo.setPartyName("无敌联盟");&emsp;//设置帮派名称 roleInfo.setRoleCreateTime("1473141432"); //值为10位数时间戳 roleInfo.setPartyId("1100"); //设置帮派id，必须为整型字符串 roleInfo.setGameRoleGender("男");&emsp; roleInfo.setGameRolePower("38"); //设置角色战力，必须为整型字符串 roleInfo.setPartyRoleId("11"); //设置角色在帮派中的id roleInfo.setPartyRoleName("帮主"); //设置角色在帮派中的名称 roleInfo.setProfessionId("38"); //设置角色职业id，必须为整型字符串 roleInfo.setProfession("法师"); //设置角色职业名称 roleInfo.setFriendlist("无"); //设置好友关系列表，格式请参考：http://open.quicksdk.net/help/detail/aid/190 创建角色 User.getInstance().setGameRoleInfo(activity, roleInfo, true); 进入游戏及角色升级 User.getInstance().setGameRoleInfo(activity, roleInfo, false);</pre> GameRoleInfo <table bordercolor="#000000" style="width:100%;" border="1" cellspacing="0" cellpadding="2"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> serverID </td> <td> String </td> <td> 服务器ID（数字字符串） </td> </tr> <tr> <td> serverName </td> <td> String </td> <td> 服务器名称 </td> </tr> <tr> <td> gameRoleName </td> <td> String </td> <td> 角色名称 </td> </tr> <tr> <td> gameRoleID </td> <td> String </td> <td> 角色ID </td> </tr> <tr> <td> gameRoleBalance </td> <td> String </td> <td> 角色用户余额 </td> </tr> <tr> <td> vipLevel </td> <td> String </td> <td> VIP等级 </td> </tr> <tr> <td> gameRoleLevel </td> <td> String </td> <td> 角色用户等级 </td> </tr> <tr> <td> partyName </td> <td> String </td> <td> 公会社团 </td> </tr> <tr> <td> roleCreateTime </td> <td> String </td> <td> 角色创建时间(10位数的unix timestamp时间戳) </td> </tr> <tr> <td> partyId </td> <td> String </td> <td> 帮派id </td> </tr> <tr> <td> gameRoleGender </td> <td> String </td> <td> 角色性别 </td> </tr> <tr> <td> gameRolePower </td> <td> String </td> <td> 战力 </td> </tr> <tr> <td> partyRoleId </td> <td> String </td> <td> 角色在帮派中的id </td> </tr> <tr> <td> partyRoleName </td> <td> String </td> <td> 角色在帮派中的名称 </td> </tr> <tr> <td> professionId </td> <td> String </td> <td> 角色职业id </td> </tr> <tr> <td> profession </td> <td> String </td> <td> 角色职业名称 </td> </tr> <tr> <td> friendlist </td> <td> String </td> <td> 好友关系列表 </td> </tr> </tbody> </table> 接入说明： 1) 在创建游戏角色、进入游戏和角色升级3个地方调用此接口，当创建角色时createRole值为true，其他两种情况为false。true & false  均需要调用一遍 2) GameRoleInfo所有字段均需上传，不能传null，游戏没有的字段可以传一个默认值（比如 default 或者 1 之类的）。 3) 关于360渠道上传角色信息的具体说明，请参考：<a href="https://www.quicksdk.com/doc-190.html?cid=15" target="_blank">https://www.quicksdk.com/doc-190.html?cid=15</a> 2.7.4  定额支付（必接） 类名：com.quicksdk.Payment 方法：public void pay(final Activity activity, final OrderInfo orderInfo, final GameRoleInfo roleInfo) 功能：调用渠道SDK支付 参数：activity 必填当前Activity orderInfo 所有参数必填订单信息 roleInfo 所有参数必填角色信息 案例： <pre class="brush:js;toolbar:false">GameRoleInfo roleInfo = new GameRoleInfo(); roleInfo.setServerID("1");//数字字符串 roleInfo.setServerName("服务器1"); roleInfo.setGameRoleName("石头"); roleInfo.setGameRoleID("1121121"); roleInfo.setRoleCreateTime("1473141432"); //值为10位数时间戳 roleInfo.setGameUserLevel("12"); roleInfo.setVipLevel("4"); roleInfo.setGameBalance("5000"); roleInfo.setPartyName("xx联盟"); OrderInfo orderInfo = new OrderInfo(); orderInfo.setCpOrderID("20150917003200119310"); orderInfo.setGoodsName("元宝");//商品名称，不带数量 orderInfo.setCount(60);//游戏币数量 orderInfo.setAmount(6); orderInfo.setGoodsID("1"); orderInfo.setGoodsDesc("Diamond_60_商品描述"); orderInfo.setPrice(0.1); orderInfo.setExtrasParams("额外参数"); orderInfo.setCallbackUrl();//游戏支付回调地址，如后台也有配置，则优先通知后台设置的地址 Payment.getInstance().pay(activity, orderInfo, roleInfo);</pre> 支付信息参数表： OrderInfo <table bordercolor="#000000" style="width:70%;" border="1" cellspacing="0" cellpadding="2"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> goodsID </td> <td> String </td> <td> 产品ID，用来识别购买的产品 </td> </tr> <tr> <td> goodsName </td> <td> String </td> <td> 产品名称 </td> </tr> <tr> <td> cpOrderID </td> <td> String </td> <td> 产品订单号（游戏方的订单号） </td> </tr> <tr> <td> count </td> <td> int </td> <td> 商品数量 </td> </tr> <tr> <td> amount </td> <td> double </td> <td> 总金额（元） </td> </tr> <tr> <td> price </td> <td> double </td> <td> 总金额（元，跟amount传一样的值就行） </td> </tr> <tr> <td> <div> goodsdesc </div> </td> <td> String </td> <td> 商品描述 </td> </tr> <tr> <td> extrasParams </td> <td> String </td> <td style="width:70%;"> 透传参数  服务器发送异步通知时原样回传(需要传纯字符串，不能传json格式) </td> </tr> </tbody> </table> 为了兼容各个渠道商品名称能够统一显示，订单应以如下案例的形式传入： 案例1：                               案例2： amount:6.0                         amount:10.0 count:60                             count:1 goodsName:元宝                 goodsName:月卡 接入要求： · GoodsName产品名称以“月卡”、“钻石”、“元宝”的形式传入，不带数量； · 其中OrderInfo中Count字段表示商品数量 · OrderInfo，GameRoleInfo所有字段均需上传且不能传null，游戏没有的字段可以传一个默认值（比如 default 或者 1 之类的） 2.7.5  注销账号（游戏自身需要登出SDK账号时进行调用） 类名：com.quicksdk.User 方法：public void logout(Activity activity) 功能：渠道SDK注销 案例： <pre class="brush:js;toolbar:false">User.getInstance().logout(activity);</pre> 2.7.6 退出（必接） 类名：com.quicksdk.Sdk 方法：public void exit(Activity activity) 功能：渠道SDK退出，游戏做退出逻辑时，先通过isShowExitDialog接口判断渠道是否有退出框，如果渠道有退出框，直接调用QuickSDK的exit接口；如果渠道没有退出框，则调用游戏自身的退出框，退出框点击“确定”后，调用QuickSDK的exit接口。 案例： <pre class="brush:js;toolbar:false">//通过isShowExitDialog判断渠道sdk是否有退出框 if(QuickSDK.getInstance().isShowExitDialog()){ Sdk.getInstance().exit(activity); }else{ // 游戏调用自身的退出对话框，点击确定后，调用quick的exit接口 new AlertDialog.Builder(MainActivity.this).setTitle("退出").setMessage("是否退出游戏?").setPositiveButton("确定", new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface arg0, int arg1) { Sdk.getInstance().exit(MainActivity.this); } }).setNegativeButton("取消", null).show(); }</pre> <h3> </h3> <h3> 3.扩展接口 </h3> <h4> 3.1 获取渠道类型 </h4> 类名：com.quicksdk.Extend 方法：public int getChannelType()/getParentChannelType() 功能：获取复制渠道的父渠道号/获取渠道号 说明：渠道ID 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().getParentChannelType();//获取复制渠道的父渠道号(推荐使用) Extend.getInstance().getChannelType();//获取渠道号</pre> 比如（渠道code：25643，渠道名：官方自用渠道）的渠道是从（渠道code：134，渠道名：QuickGame_安卓）复制而来，那么通过getParentChannelType接口获取到的值就是134，通过getChannelType接口获取到的就是25643 注意： 为了父渠道跟复制渠道的包能角色互通，推荐游戏使用getParentChannelType接口获取父渠道code做uid拼接 如果游戏服务端进行登录验证时有拼接channel_code，那么需使用getChannelType()接口获取的值进行请求 <h4 style="font-size:13.33px;white-space:normal;"> 3.2 获取设备号（DeviceID） </h4> 类名：com.quicksdk.Extend 方法：public String getDeviceID(Activity activity) 功能：获取QuickSDK定义的设备号 说明：此设备号仅以QuickSDK算法计算得来，与渠道或cp设备号不一致； 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().getDeviceID(MainActivity.this);</pre> <h4 style="white-space:normal;font-size:13.33px;"> 3.3 上传自定义数据 </h4> 类名：com.quicksdk.Extend 方法：public void uploadNode（Activity activity,String eventCode ,String eventParams） 功能：上传cp自定义的数据 说明：上传cp自定义的数据 案例： <pre class="brush:js;toolbar:false">Extend.getInstance(). uploadNode（activity,"eventCode ","eventParams"）;</pre> <h4 style="font-size:13.33px;white-space:normal;"> 3.4 获取配置参数值 </h4> 类名：com.quicksdk.Extend 方法：public String getExtrasConfig(String key) 功能：获取配置参数值 说明：运行游戏自定义参数配置在quicksdk.xml文件中，根据一定的规则，在打包的时候进行改变 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().getExtrasConfig("key");</pre> <h4> 3.5 是否支持指定方法 </h4> 类名：com.quicksdk.Extend 方法：public boolean isFunctionSupported(final int funcType) 功能：是否支持指定方法 说明：某些SDK具有打开关闭浮动工具栏、进入用户中心、进入论坛等功能，该方法可以用来判断是否支持，方便游戏中进行判断. 指定方法的定义请参见SDK库com.quicksdk.FuncType的定义 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().isFunctionSupported(FuncType.HIDE_TOOLBAR); //是否支持隐藏悬浮框功能</pre> <h4> 3.6 调用指定方法 </h4> 类名：com.quicksdk.Extend 方法：public String callFunction(final Activity activity, final int funcType) 功能：调用指定方法 说明：某些渠道有显示/隐藏悬浮按扭、进入用户中心、进入论坛等功能，该方法可以用来调用第三方渠道支持的方法，调用前请先用isFunctionSupported进行判断。 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().callFunction(activity, FuncType.HIDE_TOOLBAR); //调用隐藏悬浮框的方法</pre> <h4> 3.7 调用QuickSDK客服插件（客服属收费项目，不需要就不接） </h4> 类名：com.quicksdk.Extend 方法：public void callPlugin(final Activity activity, final int funcType，final Object ... infos) 功能：调用显示客服插件的方法 说明：母包实现按钮调用该方法，然后到QuickSDK后台添加客服插件（QuickSDKCustomService）进行打包。 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().callPlugin(MainActivity.this, FuncType.CUSTOM, "1000","嘻嘻哈哈","zzzz","1");//后四个参数请依次传入角色id，角色名，区服名，vip等级</pre> <h4 style="white-space:normal;"> 3.8 调用渠道带参数的拓展功能（以下以渠道分享功能为例） </h4> ShareInfo类字段说明 <table bordercolor="#000000" style="width:100%;" border="1" cellspacing="0" cellpadding="2"> <tbody> <tr> <td> 参数名称 </td> <td> 数据类型 </td> <td> 说明 </td> </tr> <tr> <td> title </td> <td> string </td> <td> 分享标题 </td> </tr> <tr> <td> content </td> <td> string </td> <td> 分享内容 </td> </tr> <tr> <td> imgPath </td> <td> string </td> <td> 分享图片本地地址 </td> </tr> <tr> <td> imgUrl </td> <td> string </td> <td> 分享图片网络地址 </td> </tr> <tr> <td> url </td> <td> string </td> <td> 分享链接 </td> </tr> <tr> <td> type </td> <td> string </td> <td> 分享类型 </td> </tr> <tr> <td> shareTo </td> <td> string </td> <td> 分享到哪里 </td> </tr> <tr> <td> extenal </td> <td> string </td> <td> 额外备注 </td> </tr> </tbody> </table> 类名：com.quicksdk.Extend 方法：public void callFunctionWithParams(final Activity activity, final int funcType,final Object ... infos) 功能：调用渠道的含参方法 说明：以下案例已分享为例母包调用接口传入分享对象，打出对应渠道包之后即可调起对应渠道的分享功能。 案例： <pre class="brush:js;toolbar:false">Extend.getInstance().callFunctionWithParams(MainActivity.this, FuncType.SHARE,shareInfo);</pre> <h4> 3.9 调用实名认证接口（登录成功后进行调用，目前渠道基本都做了实名跟防沉迷，游戏可以不用调此接口获取实名信息来做防沉迷限制） </h4> 类名：com.quicksdk.Extend 方法：Extend.getInstance().callFunctionWithParamsCallBack(activity, FuncType.REAL_NAME_REGISTER, callback) 功能：获取渠道实名认证信息 说明：callback的onSuccess将返回封装的json实体；uid (表示用户id)，age (表示年龄, 如果渠道没返回默认为-1)，realName (是否已实名： true表示已实名， false表示未实名；如果渠道没返回默认为 false)，resumeGame (渠道实名认证失败之后是否可以继续游戏：true表示可以， false表示不可以；如果渠道没返回默认为 true)，other (预留字段，如果渠道没返回默认为""的字符串) 返回数据示例: <pre class="brush:js;toolbar:false">{"uid":"jc453530202","resumeGame":true,"realName":false,"other":"","age":-1}</pre> 案例： <pre class="brush:js;toolbar:false">private void verifyRealName() { final Activity activity = this; activity.runOnUiThread(new Runnable() { @Override public void run() { // 判断渠道是否支持实名认证功能 if (Extend.getInstance().isFunctionSupported(FuncType.REAL_NAME_REGISTER)) { Extend.getInstance().callFunctionWithParamsCallBack(activity, FuncType.REAL_NAME_REGISTER, new BaseCallBack() { @Override public void onSuccess(Object... arg0) { if (arg0 != null && arg0.length > 0) { JSONObject jsonObject = (JSONObject) arg0[0]; Log.d("json", "==========" + jsonObject.toString()); try { // 用户id String uid = jsonObject.getString("uid"); // 年龄, 如果渠道没返回默认为-1 int age = jsonObject.getInt("age"); // 是否已实名 true表示已实名 // false表示未实名,如果渠道没返回默认为false boolean realName = jsonObject.getBoolean("realName"); // oppo实名认证失败之后是否可以继续游戏 true表示可以 // false表示不可以,如果渠道没返回默认为true boolean resumeGame = jsonObject.getBoolean("resumeGame"); // 预留字段,如果渠道没返回默认为""的字符串 String other = jsonObject.getString("other"); // 游戏根据返回信息做对应的逻辑处理 } catch (JSONException e) { } } } @Override public void onFailed(Object... arg0) { } }); } } }); }</pre> <h4> 3.10 调用隐私弹窗接口（如游戏自己有隐私弹窗则不必再调用） </h4> 详细操作见文档：<a href="https://www.quicksdk.com/doc-1042.html?cid=32" target="_blank">游戏如何调用QuickSDK的隐私弹窗</a> <h3> 4.其他 </h3> <h4> 4.1 关于混淆 </h4> QuickSDK 已经经过了混淆，如果要混淆java代码，请不要混淆联编的jar包中的类。可以添加以下类到proguard配置，排除在混淆之外： -keep class com.quicksdk.** { *; } <h4> 4.2 配置自定义参数 </h4> 当游戏当游戏需要设置渠道相关的参数时。可以通过Quick后台添加自定义参数，在渠道列表中配置对应的值，最后通过Extend.getInstance().getExtrasConfig(String key)可以获取到该值。 <h4> 4.3 测试要求 </h4> 所有接口接入完成后，生成的母包，应严格按照母包测试用例进行测试，测试通过后，方可打出正确的渠道包。