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

更新日期：2017年 12月 01日QuickSDK-Java（Android）

<h3 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">1. Examing project before access</h3>There are some requirements that QuickSDK suggest to game projectthe following problems after game accessed QuickSDK,· Android:targetSdkVersion of AndroidManifest.xml ="19"Fix the problem that market sdk is incompatible to android 5.0· If there is installLocation in AndroidManifest.xml, parameter set as autoTo solve the problem that APK can not be installed· The Activity in AndroidManifest.xml shall configured as followed<pre class="brush:java;toolbar:false">android:configChanges="keyboardHidden|orientation|screenSize"</pre>In case of the landscape-portrait swichover problem that may happened between game and market sdk.·U3D game project ,AndroidManifest.xml<pre class="brush:java;toolbar:false"><meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" /></pre>Android: value set as true· Add Landscape-portrait screen setting for ActivityActivity Landscape-portrait screen according to game screen orientation<pre class="brush:java;toolbar:false">android:screenOrientation="sensorLandscape" android:screenOrientation="sensorPortrait"</pre>or<pre class="brush:java;toolbar:false">android:screenOrientation="landscape" android:screenOrientation="portrait"</pre>· Component path in AndroidManifest.xml such as Activity is full pathAll contents under “com.quicksdk” class path will be deleted when packing market package if you used the class path “com.quicksdk” when create game project.<h3 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.Access process</h3><h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.1 Add resource</h4>Loading QuickSDK resource(<a href="http://www.quicksdk.com/download.html">http://www.quicksdk.com/download.html</a>), and copy assets,libs and res to project corresponding files.<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.2 Add authority</h4>Adding authority in Androidmanifest.xml<pre class="brush:java;toolbar:false"><uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <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.SYSTEM_ALERT_WINDOW" /> <uses-permission android:name="android.permission.BLUETOOTH" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /></pre><h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.3 Add QuickSdkApplication</h4><h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.3.1  Create game application</h5>The creating game Application inherit from QuickSdkApplication<pre class="brush:java;toolbar:false">public class GameApplication extends QuickSdkApplication {       @Override     public void onCreate() {         super.onCreate();     }   }</pre> <h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.3.2   Add Application to AndroidManifest.xml</h5>Application nude in AndroidManifest.xml, modifying android:name nature, whose value is full path of game new creating Application.<pre class="brush:java;toolbar:false"><application     android:name="*.*.*.GameApplication"     android:allowBackup="true"     android:icon="@drawable/ic_launcher"     android:label="@string/app_name" >     ...... </application></pre> <h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.4 Add splash screen</h4><h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.4.1  Create game splash screen Activity</h5>Create game splash screen Activity，which is inherit from QuickSdkSplashActivity<pre class="brush:java;toolbar:false">public class SplashActivity extends QuickSdkSplashActivity {        @Override     public int getBackgroundColor() {         return Color.WHITE;     }     @Override     public void onSplashStop() {         //turn to game interface after splash screen stopped         Intent intent = new Intent(this, MainActivity.class);         startActivity(intent);         this.finish();     } }</pre> <h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.4.2   Add splash screen Activity to AndroidManifest.xml</h5><activity    android:name="*.*.*.SplashActivity"    android:configChanges="keyboardHidden|orientation|screenSize"    android:screenOrientation="landscape" >    <intent-filter>        <action android:name="android.intent.action.MAIN" />         <category android:name="android.intent.category.LAUNCHER" />    </intent-filter></activity> Instruction：android:name nature，whose value is full path of game-defined splash screen activity.android:screenOrientation nature， whose value decided the screen orientation according to game needs. <h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.5 Life cycle processing</h4>Game Activity life cycle processing, call corresponding method.<pre class="brush:java;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 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6 QuickSDK initialized setting</h4><h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6.1   Set initialized notification( necessarily)</h5>Class：QuickSDKMethod：public QuickSDK setInitNotifier(InitNotifier notifier)Function：Setting initialized result callback notification before game started, Started game log in etc and relevant processes once initialized successfully.Example:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setInitNotifier(new InitNotifier() {     @Override         public void onSuccess() {                 //initialized succeed         }         @Override         public void onFailed(String message, String trace) {                 //initialized failed         }     });</pre> <h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6.2  Set log in notification (necessarily)</h5>Class：QuickSDKMethod：public QuickSDK setLoginNotifier(LoginNotifier notifier)Function： Setting relevant processing of user log in result callback notification.Example:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setLoginNotifier(new LoginNotifier() {     @Override     public void onSuccess(UserInfo userInfo) {         // log in succeed, get user information userInfo         // certificate server log in through UID, token of userInfo     }     @Override     public void onCancel() {         //log in cancel     }     @Override     public void onFailed(final String message, String trace) {         //log in failed     } });</pre> Log in information：UserInfo      <table cellpadding="0" cellspacing="0" width="408"><tbody><tr class="firstRow"><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="34">Field</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="23">type</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="104">Instruction</td></tr><tr><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="34">UID</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="23">String</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="104">User ID， the only ID that SDK returned to</td></tr><tr><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="34">username</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="23">String</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="104">User name</td></tr><tr><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="34">token</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="23">String</td><td style="border:solid #7F7F7F 1px;padding:0 7px 0 7px" width="104">Verifying user token</td></tr></tbody></table>       Access requirements：1）Initiate game, received log in succeed notification in login interface, then skip to game interface;2）When game client call auto login receiving login fail/cancel notification, shall call login function again.3）Different markets may return  same UID， the only method that game client use to identify user is ID+UID. To obtain market ID by “public int getChannelType()”<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6.3  Set log out notification(necessarily)</h5>Class：QuickSDKMethod：public QuickSDK setLogoutNotifier(LogoutNotifier notifier)Function： Set process such as user log out result , callback notificationExample:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setLogoutNotifier(new LogoutNotifier() {     @Override     public void onSuccess() {         //log out succeed                }     @Override     public void onFailed(String message, String trace) {         // log out fail, no processing     } });</pre> Access requirement: Receiving log out succeed notification , game shall return to login interface.<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6.4  Set switch account notification(necessarily)</h5>Class：QuickSDKMethod：public QuickSDK setSwitchAccountNotifier(SwitchAccountNotifier notifier)Function：Set the processing of user switch account result callback notification.Example:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setSwitchAccountNotifier(new SwitchAccountNotifier() {           @Override         public void onSuccess(UserInfo userInfo) {             // userInfo Switch account succeed, return to new account userInfo         }           @Override         public void onCancel() {             //Switch account cancel         }                   @Override         public void onFailed(String message, String trace) {             //Switch account fail         }     })</pre> Switch account succeed information：UserInfo<table cellpadding="0" width="408"><tbody><tr class="firstRow"><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="25">Field</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="19">Type</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="117">Instruction</td></tr><tr><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="25">UID</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="19">String</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="117">User ID,the only ID that SDK   returned</td></tr><tr><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="25">username</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="19">String</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="117">User login name </td></tr><tr><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="25">token</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="19">String</td><td style="border:solid #7F7F7F 1px;padding:1px 1px 1px 1px" valign="top" width="117">User verify token</td></tr></tbody></table>      Access requirement: In game interface ,receiving switch account succeed notification, game client log out current role, using new user information, back to access game interface.<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;"> 2.6.5  Set fixed payment notification (necessarily)</h5>Class：QuickSDKMethod：public QuickSDK setPayNotifier(PayNotifier notifier)Function： Set relevant process of user payment result callback notificationExample:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setPayNotifier(new PayNotifier() {     @Override     public void onSuccess(String sdkOrderID, String cpOrderID,         String extrasParams) {             //Paid succeed             //sdkOrderID:quick Order number cpOrderID：Game client order number          }     @Override     public void onCancel(String cpOrderID) {         //payment cancel     }     @Override     public void onFailed(String cpOrderID, String message, String trace) {         //payment fail     } });</pre> Instruction: Whether the game recharge succeed according to the only official notification from server.(Since some market SDK may not send the correct notification , the client notification is not that reliable)<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.6.6 Set exit notification(necessarily)</h5>Class：QuickSDKMethod：public  QuickSDK  setExitNotifier(ExitNotifier notifier)Function： Set relevant process of user exit result callback notification.Example:<pre class="brush:java;toolbar:false">QuickSDK.getInstance().setExitNotifier(new ExitNotifier() {     @Override     public void onSuccess() {         // exit succeed, exit process itself     }     @Override     public void onFailed(String message, String trace) {         // Exit fail, no processing     } });</pre> Access requirement: Game exit processing itself after receiving exit succeed notification.<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7 Call market SDK API</h4>Access requirement: Call SDK API under UI main thread.<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.1   SDK initialization (necessarily)</h5>Class：com.quicksdk.SdkMethod：public void init(Activity activity, String productCode, String productKey)Function：Market SDK initializationParameter：activity  always the current ActivityproductCode always the productCode which is applied in QuickSDK background  productKey always productKey which is applied in QuickSDK backgroundExample:<pre class="brush:java;toolbar:false">com.quicksdk.Sdk.getInstance().init(activity, " productCode applied in background", " productKey applied in background ");</pre> Access requirement: Initializing API shall be called onCreate method of Activity<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.2  Login account (necessarily)</h5>Class：com.quicksdk.UserMethod：public void login(Activity activity)Function： Call market SDK loginParameter：activity always current ActivityExample:<pre class="brush:java;toolbar:false">User.getInstance().login(activity);</pre> Access requirement: Entering login interface, autocall this API, and call login API after initialized succeed.<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.3  Uploading role information(necessarily)</h5>Name：com.quicksdk.UserMethod：public void setGameRoleInfo(Activity activity, GameRoleInfo roleInfo, boolean createRole)Function： Uploading role information to Market SDKParameter：activity always current ActivityroleInfo always role informationcreateRole always if create roleExample:<pre class="brush:java;toolbar:false">// GameRoleInfo field, it must be transferred once there are parameters of game in GameRoleInfo field,and it’s unnecessary to transfer the parameters which are not in GameRoleInfo field. GameRoleInfo roleInfo = new GameRoleInfo(); roleInfo.setServerID("1");// number string , which can not including Chinese character. roleInfo.setServerName("server 1"); roleInfo.setGameRoleName("stone"); roleInfo.setGameRoleID("1121121"); roleInfo.setGameBalance("5000"); roleInfo.setVipLevel("4"); 　// Setting the current users VIP level which must be integer string. roleInfo.setGameUserLevel("12");　// Setting game user level roleInfo.setPartyName("Unstoppable");　// Setting party name roleInfo.setRoleCreateTime("1473141432"); // There are 3 market must transfer, they are UC.com,dangle.com and 1881.com respectively, and the value is 10 digit timestamp. roleInfo.setPartyId("1100"); // 360.com parameters, set party ID which must be integer string. roleInfo.setGameRoleGender("male");　//market 360/360.com parameter roleInfo.setGameRolePower("38"); // 360.com parameter, set role power,which must be integer string. roleInfo.setPartyRoleId("11"); // 360.com parameter ,set party role id. roleInfo.setPartyRoleName("party leader"); // 360.com parameter set party role name. roleInfo.setProfessionId("38"); // 360.com parameter,set role profession id which must be integer string. roleInfo.setProfession("master"); // 360.com parameter , set role profession name. roleInfo.setFriendlist("no"); //360.com parameter, set friend list，format refer to：http://open.quicksdk.net/help/detail/aid/190</pre> Creating Role<pre class="brush:java;toolbar:false">User.getInstance().setGameRoleInfo(activity, roleInfo, true);</pre> Entering game and updating role<pre class="brush:java;toolbar:false">User.getInstance().setGameRoleInfo(activity, roleInfo, false);</pre>                                               GameRoleInfo<table cellpadding="0" cellspacing="0" width="408"><tbody><tr class="firstRow"><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">string</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">type</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">Instructino</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">serverID</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">server ID(number string)</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">serverName</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">server name</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">gameRoleName</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">Game Role name</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">gameRoleID</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">Game Role ID</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">gameRoleBalance</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">Game role balance</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">vipLevel</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">VIP level</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">gameRoleLevel</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">game role level</td></tr><tr><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="73">partyName</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="43">String</td><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="94">Party </td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">roleCreateTime</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">role  create time (10 digit timestamp)</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">partyId</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Party id</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">gameRoleGender</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Game role gender</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">gameRolePower</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Role power</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">partyRoleId</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Party role ID</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">partyRoleName</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Party role name </td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">professionId</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Role profession ID</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">profession</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Role profession name</td></tr><tr><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="73">friendlist</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="43">String</td><td style="border:solid windowtext 1px;padding:0 0 0 0" valign="top" width="94">Friend list</td></tr></tbody></table> Access instruction:1) Call this API when creating role, entering game and updating role. createRole value is true while creating game role, for the rest situations—entering game or updating role, the value is false.2) All strings in GameRoleInfo can not transfer null , if there is no such string, transfer default value or null string.3) In roleCreateTime field, only UC.com and 1881.com must transfer this parameter, whose value is 10 digit timestamp.4) It is necessarily for 360.com to transfer these 8 fields --partyId,gameRoleGender,gameRolePower,partyRoleId,partyRoleName,professionId,profession,friendlist,only transfer the fields which included in game, other markets do not need to transfer them.5) Specific instruction of uploading role information to 360.com, refer to :http://open.quicksdk.net/help/detail/aid/190<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.4 Fixed payment(necessarily)</h5>Class ：com.quicksdk.PaymentMethod ：public void pay(final Activity activity, final OrderInfo orderInfo, final GameRoleInfo roleInfo)Function： call market SDK payParameter：activity always current ActivityorderInfo always order informationroleInfo always role informationExample：<pre class="brush:java;toolbar:false">GameRoleInfo roleInfo = new GameRoleInfo(); roleInfo.setServerID("1");//number string roleInfo.setServerName("server1"); roleInfo.setGameRoleName("stone"); roleInfo.setGameRoleID("1121121"); roleInfo.setGameUserLevel("12"); roleInfo.setVipLevel("Vip4"); roleInfo.setGameBalance("5000"); roleInfo.setPartyName("xxparty"); OrderInfo orderInfo = new OrderInfo(); orderInfo.setCpOrderID("20150917003200119310"); orderInfo.setGoodsName("yuanbao");// goods name without quantity orderInfo.setCount(60);// game currency quantity orderInfo.setAmount(6); orderInfo.setGoodsID("1"); orderInfo.setExtrasParams("extra parameter"); Payment.getInstance().pay(activity, orderInfo, roleInfo);</pre> payment information parameter form：OrderInfo <table cellpadding="0" cellspacing="0" width="408"><tbody><tr class="firstRow"><td style="border: 1px solid windowtext; padding: 0px 7px;" valign="top" width="71">field</td><td style="border-width: 1px 1px 1px medium; border-style: solid solid solid none; border-color: windowtext windowtext windowtext -moz-use-text-color; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="43">type</td><td style="border-width: 1px 1px 1px medium; border-style: solid solid solid none; border-color: windowtext windowtext windowtext -moz-use-text-color; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="95">instruction</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">goodsID</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">String</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">Goods ID, identifying the purchased goods.</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">goodsName</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">String</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">goods name</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">cpOrderID</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">String</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">Goods order number( game client order number)</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">count</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">int</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">game currency quantity</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">amount</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">double</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">Total amount(¥)</td></tr><tr><td style="border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color windowtext windowtext; -moz-border-top-colors: none; -moz-border-right-colors: none; -moz-border-bottom-colors: none; -moz-border-left-colors: none; border-image: none; padding: 0px 7px;" valign="top" width="71">extrasParams</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="43">String</td><td style="border-width: medium 1px 1px medium; border-style: none solid solid none; border-color: -moz-use-text-color windowtext windowtext -moz-use-text-color; padding: 0px 7px;" valign="top" width="95">Extras parameter</td></tr></tbody></table>In order to unify all market goods name, orders should be transferred in by following patterns:Example 1：                              Example2：amount:6.0                         amount:10.0count:60                             count:1goodsName: yuanbao            goodsName: month cardAccess requirement：· GoodsName transferred in “month card”,”diamond”,”yuanbao”pattern without quantity;· Field Count in OrderInfo stands for game currency quantity.·All fields in OrderInfo, GameRoleInfo can not transfer null, if there’s no such field in game transferring a default value or null string/empty string.<h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.5 Log out (necessarily)</h5>Class：com.quicksdk.UserMethod：public void logout(Activity activity)Function： market SDK log out.Example:<pre class="brush:java;toolbar:false">User.getInstance().logout(activity);</pre> <h5 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">2.7.6 Exit (necessarily)</h5>Class：com.quicksdk.SdkMethod：public void exit(Activity activity)Function： Market SDK exit, when game server is in exiting logic, we can judge if there is exitdialog by isShowExitDialog API. Call QuickSDK exit API directly if there is exit dialog; call exit dialog by game itself, click “yes”,then call QuickSDK exit API if there’s no exit dialog in market.Example:<pre class="brush:java;toolbar:false">// Judging if there is exit dialog in market SDK by isShowExitDialog if(QuickSDK.getInstance().isShowExitDialog()){     Sdk.getInstance().exit(activity); }else{ //  call exit dialog of game, click “yes”,then call quick exit API     new AlertDialog.Builder(MainActivity.this).setTitle("退出").setMessage("if exit game?").setPositiveButton("yes", new DialogInterface.OnClickListener() {         @Override         public void onClick(DialogInterface arg0, int arg1) {             Sdk.getInstance().exit(MainActivity.this);         }     }).setNegativeButton("cancel", null).show(); }</pre> <h3 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">3. Expansion API</h3><h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">3.1 Obtain market type</h4>Class ：com.quicksdk.ExtendMethod：public int getChannelType()Function：obtain market numberInstruction：Market IDExample：Extend.getInstance().getChannelType();<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">3.2 Obtain configuration parameter value</h4>Class ：com.quicksdk.ExtendMethod ：public String getExtrasConfig(String key)Function：obtain configuration parameter valueInstruction：Operating game defined parameter configuration in quicksdk.xml files, change it when packaging according to the rules.Example：Extend.getInstance().getExtrasConfig("key");<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">3.3 Supporting designated method?</h4>Class ：com.quicksdk.ExtendMethod ：public boolean isFunctionSupported(final int funcType)Function： whether it supports designated method.Instruction： There are functions in some SDK such as open/close floating tool bar, enter user center, enter forum; it can be used for judging whether it support the designated method during gaming;definition of  designated method refer to SDK lib com.quicksdk.FuncType.Example ：Extend.getInstance().isFunctionSupported(FuncType.HIDE_TOOLBAR); // if it support hiding floating dialog function<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">3.4 Call designated method</h4>Class ：com.quicksdk.ExtendMethod :public String callFunction(final Activity activity, final int funcType)Function： call designated methodInstruction： There are functions such as display/hide floating button, enter user center, enter forum, it can call third party market supporting method before using isFunctionSupported to judge.Example：Extend.getInstance().callFunction(activity, FuncType.HIDE_TOOLBAR); // call hide floating dialog method<h3 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">4.others</h3><h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">4.1 About mix   </h4>QuickSDK has been through mixed,  if java code is mixed, do not mix the bider classes in jar package. And it can add following class to proguard configuration, excluding the mix:-keep class com.quicksdk.** { *; }<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">4.2 configure self-defined parameter</h4>Once there are some needs for game client to set relevant market parameter, it can add self-defined parameter through quick background, configure corresponding value in market list, then obtain the value through Extend.getInstance().getExtrasConfig(String key).<h4 style="margin-top: auto; margin-bottom: auto; text-align: left; line-height: 3em;">4.3  test requirement </h4> All API access succeed, there is the origin package, which is the test example for testing, and when it passed test, there is the correct market package.