Commit 567fae849ba4794fc3d6712732780b5f351d80ca
1 parent
6a217e5ca6
Exists in
master
update readme document
Showing 2 changed files with 251 additions and 251 deletions Side-by-side Diff
README
| ... | ... | @@ -1,251 +0,0 @@ |
| 1 | -# Gump SDK 4 for Android接入文档 | |
| 2 | - | |
| 3 | -V4.5.0 | |
| 4 | -2018年6月13日 | |
| 5 | - | |
| 6 | -## 版本概述 | |
| 7 | - | |
| 8 | -此版本为使用AndroidStudio开发的版本,一改eclipse的工程依赖方式,使用aar的方式提供sdk接入包,除功能外,相对上一版本没有继承关系,请按此文档描述接入. | |
| 9 | - | |
| 10 | -此SDK适用android4.0以上系统. | |
| 11 | - | |
| 12 | -## 第一章 接入指南 | |
| 13 | -### 1.依赖导入 | |
| 14 | -配置gradle,以下为必须项 | |
| 15 | - | |
| 16 | - repositories{ | |
| 17 | - maven{ | |
| 18 | - url "http://117.50.8.198:8081/nexus/content/repositories/sdk" | |
| 19 | - } | |
| 20 | - } | |
| 21 | - dependencies { | |
| 22 | - implementation 'com.gumptech.sdk:GameSDK:4.4.0' | |
| 23 | - } | |
| 24 | - | |
| 25 | - | |
| 26 | -可选接入vk登录时,需要导入vkLibrary工程,并配置模块依赖,如下 | |
| 27 | - | |
| 28 | - implementation 'com.gumptech:VKsdk:1.5.4' | |
| 29 | - | |
| 30 | -选择接入微信登录时，需要增加微信依赖，如下： | |
| 31 | - | |
| 32 | - implementation 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:5.1.4' | |
| 33 | - | |
| 34 | -### 2.修改AndroidManifest.xml文件 | |
| 35 | -首先添加必要的权限，如下所示： | |
| 36 | - | |
| 37 | - <uses-permission android:name="android.permission.INTERNET" /> | |
| 38 | - <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> | |
| 39 | - <uses-permission android:name="android.permission.GET_ACCOUNTS"/> | |
| 40 | - <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | |
| 41 | - <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | |
| 42 | - <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> | |
| 43 | - <uses-permission android:name="com.android.vending.BILLING" /> | |
| 44 | - | |
| 45 | -其次注册相应的Activity，具体如下： | |
| 46 | - | |
| 47 | - <activity | |
| 48 | - android:name="com.gumptech.sdk.ContainerActivity" | |
| 49 | - android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 50 | - android:windowSoftInputMode="stateAlwaysHidden|adjustPan" | |
| 51 | - android:launchMode="singleTask" | |
| 52 | - android:theme="@style/Theme.TransparentWin" > | |
| 53 | - </activity> | |
| 54 | - <activity | |
| 55 | - android:name="com.gumptech.sdk.PaymentActivity" | |
| 56 | - android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 57 | - android:launchMode="singleTask" | |
| 58 | - android:theme="@android:style/Theme.Translucent.NoTitleBar" > | |
| 59 | - <intent-filter> | |
| 60 | - <category android:name="android.intent.category.DEFAULT" /> | |
| 61 | - <action android:name="android.intent.action.VIEW" /> | |
| 62 | - <category android:name="android.intent.category.BROWSABLE" /> | |
| 63 | - <data | |
| 64 | - android:host="com.gump.sdk" | |
| 65 | - android:scheme="gump+游戏的appId" /> | |
| 66 | - </intent-filter> | |
| 67 | - </activity> | |
| 68 | - <activity | |
| 69 | - android:name="com.gumptech.sdk.ExchangeWindow" | |
| 70 | - android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 71 | - android:theme="@style/Theme.WinForExchange" > | |
| 72 | - </activity> | |
| 73 | - | |
| 74 | - <service android:name="com.gumptech.sdk.PushService" /> | |
| 75 | - | |
| 76 | - <!-- vk登录使用，若不接入vk，不需配置 --> | |
| 77 | - <activity android:name="com.vk.sdk.VKOpenAuthActivity" /> | |
| 78 | - <activity | |
| 79 | - android:name="com.vk.sdk.VKServiceActivity" | |
| 80 | - android:label="ServiceActivity" | |
| 81 | - android:theme="@style/VK.Transparent" /> | |
| 82 | - <!--wechat接入使用，不接入不需要配置--> | |
| 83 | - <activity | |
| 84 | - android:name=".wxapi.WXEntryActivity" | |
| 85 | - android:exported="true"></activity> | |
| 86 | - | |
| 87 | -### 3.向Gump平台索要游戏ID（AppID），完成代码接入 | |
| 88 | -正式开始接入逻辑代码前,先介绍下一些附加设置,以方便代码接入 | |
| 89 | - | |
| 90 | -*是否打印debug日志 | |
| 91 | - | |
| 92 | - GumpSDK.getSettings().enableDebugLogging(true); | |
| 93 | - | |
| 94 | -*横竖屏控制,默认为横屏,参数为false即为竖屏 | |
| 95 | - | |
| 96 | - GumpSDK.getSettings().setScreenLandscape(true); | |
| 97 | - | |
| 98 | -*设置需要启用的第三方登录，参数可选类型见第二章：[第三方登录平台](http://repository.gumptech.com:81/document/gamesdk4-android/blob/master/IntegrationGuide.md#1-third_plat) 字段说明 | |
| 99 | - | |
| 100 | - GumpSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_*)； | |
| 101 | - | |
| 102 | -*若要使用V4版支付请设置 | |
| 103 | - | |
| 104 | - GumpSDK.getSettings().setPaymentVersion(PaymentVersion.V4); | |
| 105 | - | |
| 106 | -#### 1.调用GumpSDK前需要执行初始化。 | |
| 107 | - | |
| 108 | -若不需要分渠道 | |
| 109 | - | |
| 110 | - GumpSDK.init(Context,Appid, Appkey,InitializeCallback); | |
| 111 | -如果需要定义渠道,必须使用如下方法 | |
| 112 | - | |
| 113 | - GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback); | |
| 114 | - | |
| 115 | -InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败 | |
| 116 | - | |
| 117 | -#### 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 | |
| 118 | - | |
| 119 | - GumpSDK.start(Activity); | |
| 120 | -在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下: | |
| 121 | - | |
| 122 | - GumpSDK.setUserStateListener(new LoginStateListener() { | |
| 123 | - @Override | |
| 124 | - public void onLoginSuccess(GumpUser gumpUser) { | |
| 125 | - //登录成功,用户信息包含在GumpUser对象里 | |
| 126 | - } | |
| 127 | - | |
| 128 | - @Override | |
| 129 | - public void onLoginFailed(int code, String msg) { | |
| 130 | - //登录出错,根据错误码和信息判断错误类型 | |
| 131 | - Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show(); | |
| 132 | - } | |
| 133 | - | |
| 134 | - @Override | |
| 135 | - public void onLoginCanceled() { | |
| 136 | - //用户取消登录 | |
| 137 | - Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show(); | |
| 138 | - } | |
| 139 | - | |
| 140 | - @Override | |
| 141 | - public void onLogout() { | |
| 142 | - //用户登出 | |
| 143 | - | |
| 144 | - } | |
| 145 | - @Override | |
| 146 | - public void onPermissionDenied() { | |
| 147 | - //用户拒绝授予权限 | |
| 148 | - } | |
| 149 | - }); | |
| 150 | - | |
| 151 | -如上成功登录后收到的GumpUser对象包含以下信息 | |
| 152 | - | |
| 153 | - gumpUser.getUid();//获取用户的userid,此Id标识唯一用户! | |
| 154 | - gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取 | |
| 155 | - gumpUser.getSessionKey();//登录的sessionKey对象,获取sessionKey字符串请使用此对象的getToken()方法 | |
| 156 | - | |
| 157 | -***注意：若需要使用微信登录，需要在packageName.wxapi下增加一个名为WXEntryActivity并继承com.gumptech.sdk.WXCallbackActivity的Activity，并参考AndroidManifest.xml设置的说明，做相应的配置，packageName为应用的包名，此Activity不须任何实现。*** | |
| 158 | - | |
| 159 | -***以GumpSDKDemo为例，包名为com.gumptech.sdk.demo，则WXEntryActivity的完整包路径为：com.gumptech.sdk.demo.wxapi.WXEntryActivity*** | |
| 160 | - | |
| 161 | -#### 3.支付功能 | |
| 162 | -1)使用gump通行证登录,其中除nick外所有参数为必传参数 | |
| 163 | - | |
| 164 | - Bundle payInfo = new Bundle(); | |
| 165 | - payInfo.putString("nick", "thi"); | |
| 166 | - payInfo.putString("product", "元宝"); | |
| 167 | - payInfo.putFloat("amount", 40.0f); | |
| 168 | - payInfo.putString("extraInfo", "This is demo!"); | |
| 169 | - payInfo.putString("serverId", "B4003"); | |
| 170 | - payInfo.putString("roleId", "10010"); | |
| 171 | - payInfo.putString("sessionKey","sessionkey"); | |
| 172 | - GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback); | |
| 173 | -调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含,其中sessionKey为登录时返回的sessionKey | |
| 174 | - | |
| 175 | - | |
| 176 | -2)IAP支付 | |
| 177 | - | |
| 178 | - Bundle payInfo = new Bundle(); | |
| 179 | - payInfo.putString("product", "gp_skuId"); | |
| 180 | - payInfo.putFloat("amount", 0.1f); | |
| 181 | - payInfo.putString("extraInfo", "This is demo!"); | |
| 182 | - payInfo.putString("serverId", "100"); | |
| 183 | - payInfo.putString("roleId","100123"); | |
| 184 | - GumpSDK.iap(MainActivity.this, payInfo, PurchaseCallback); | |
| 185 | - | |
| 186 | -3)PurchaseCallback为支付状态回调接口,此接口含有3个方法 | |
| 187 | - | |
| 188 | - @Override | |
| 189 | - public void onPurchaseCompleted(PurchaseResult result) { | |
| 190 | - Log.i(TAG,"purchase completed"); | |
| 191 | - } | |
| 192 | - | |
| 193 | - @Override | |
| 194 | - public void onPurchaseError(int code, String msg) { | |
| 195 | - Log.i(TAG,"purchase error"); | |
| 196 | - } | |
| 197 | - | |
| 198 | - @Override | |
| 199 | - public void onPurchaseCanceled() { | |
| 200 | - Log.i(TAG,"purchase canceled"); | |
| 201 | - } | |
| 202 | - | |
| 203 | -#### 4.注销登录 | |
| 204 | - | |
| 205 | - GumpSDK.logout(Activity); | |
| 206 | -当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序!为了便于用户切换登录账户,请在游戏内提供用户注销的触发按钮 | |
| 207 | -#### 5.运营开关接口，若需要接入，会有我方运营人员提出需求，否则不需要接入（若对此接口不知所云，即可认为不需要接入，请自行忽略） | |
| 208 | - | |
| 209 | - GumpSDK.checkRisk(this, new ResultCallback() { | |
| 210 | - @Override | |
| 211 | - public void onResult(boolean result) { | |
| 212 | - Log.i(TAG,result?"There is some risks":"Nothing is risk"); | |
| 213 | - } | |
| 214 | - }); | |
| 215 | - | |
| 216 | -## 第二章 常量字段与代码 | |
| 217 | -### 1.第三方登录平台(third_plat) | |
| 218 | - | 常量字段 | 说明 | | |
| 219 | - |--------------------------------|--------------| | |
| 220 | - |SDKSettings.THIRD_SUPPORT_FB |Facebook登录 | | |
| 221 | - |SDKSettings.THIRD_SUPPORT_GOOGLE|Google登录 | | |
| 222 | - |SDKSettings.THIRD_SUPPORT_LINE |Line登录 | | |
| 223 | - |SDKSettings.THIRD_SUPPORT_VK |VK登录 | | |
| 224 | - |SDKSettings.THIRD_SUPPORT_WECHAT|微信登录 | | |
| 225 | -### 2.登录账户类型 | |
| 226 | - | 常量字段 | 说明 | | |
| 227 | - |-------------------------------------|-------------| | |
| 228 | - |GumpPreference.ACCOUNT_TYPE_FB |Facebook用户 | | |
| 229 | - |GumpPreference.ACCOUNT_TYPE_REG |Gump注册用户 | | |
| 230 | - |GumpPreference.ACCOUNT_TYPE_QUICK_REG|快速注册用户 | | |
| 231 | - |GumpPreference.ACCOUNT_TYPE_GOOGLE |Google用户 | | |
| 232 | - |GumpPreference.ACCOUNT_TYPE_LINE |Line用户 | | |
| 233 | - |GumpPreference.ACCOUNT_TYPE_VK |VK用户 | | |
| 234 | - |GumpPreference.ACCOUNT_TYPE_WECHAT |微信用户 | | |
| 235 | - | |
| 236 | -## 第三章 常见问题 | |
| 237 | -### 问题1： 如何避免混淆对SDK的影响？ | |
| 238 | -解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java | |
| 239 | -类，导致SDK无法正常工作，解决方法如下: | |
| 240 | -Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 | |
| 241 | - | |
| 242 | - -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable | |
| 243 | - -keep public class * extends android.app.Service | |
| 244 | - -keep public class com.google.vending.licensing.ILicensingService | |
| 245 | - -keep public class com.android.vending.licensing.ILicensingService | |
| 246 | - -keep class com.gumptech.sdk.view.* {*;} | |
| 247 | - -keep class com.gumptech.sdk.web.* {*;} | |
| 248 | - -keep class com.gumptech.sdk.bridge.impl.*{*;} | |
| 249 | - | |
| 250 | - | |
| 251 | -使得混淆的时候不会影响SDK的命名空间。 | |
| 252 | 0 | \ No newline at end of file |
README.md
| ... | ... | @@ -0,0 +1,251 @@ |
| 1 | +# Gump SDK 4 for Android接入文档 | |
| 2 | + | |
| 3 | +V4.5.0 | |
| 4 | +2018年6月13日 | |
| 5 | + | |
| 6 | +## 版本概述 | |
| 7 | + | |
| 8 | +此版本为使用AndroidStudio开发的版本,一改eclipse的工程依赖方式,使用aar的方式提供sdk接入包,除功能外,相对上一版本没有继承关系,请按此文档描述接入. | |
| 9 | + | |
| 10 | +此SDK适用android4.0以上系统. | |
| 11 | + | |
| 12 | +## 第一章 接入指南 | |
| 13 | +### 1.依赖导入 | |
| 14 | +配置gradle,以下为必须项 | |
| 15 | + | |
| 16 | + repositories{ | |
| 17 | + maven{ | |
| 18 | + url "http://117.50.8.198:8081/nexus/content/repositories/sdk" | |
| 19 | + } | |
| 20 | + } | |
| 21 | + dependencies { | |
| 22 | + implementation 'com.gumptech.sdk:GameSDK:4.4.0' | |
| 23 | + } | |
| 24 | + | |
| 25 | + | |
| 26 | +可选接入vk登录时,需要导入vkLibrary工程,并配置模块依赖,如下 | |
| 27 | + | |
| 28 | + implementation 'com.gumptech:VKsdk:1.5.4' | |
| 29 | + | |
| 30 | +选择接入微信登录时，需要增加微信依赖，如下： | |
| 31 | + | |
| 32 | + implementation 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:5.1.4' | |
| 33 | + | |
| 34 | +### 2.修改AndroidManifest.xml文件 | |
| 35 | +首先添加必要的权限，如下所示： | |
| 36 | + | |
| 37 | + <uses-permission android:name="android.permission.INTERNET" /> | |
| 38 | + <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> | |
| 39 | + <uses-permission android:name="android.permission.GET_ACCOUNTS"/> | |
| 40 | + <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | |
| 41 | + <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | |
| 42 | + <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> | |
| 43 | + <uses-permission android:name="com.android.vending.BILLING" /> | |
| 44 | + | |
| 45 | +其次注册相应的Activity，具体如下： | |
| 46 | + | |
| 47 | + <activity | |
| 48 | + android:name="com.gumptech.sdk.ContainerActivity" | |
| 49 | + android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 50 | + android:windowSoftInputMode="stateAlwaysHidden|adjustPan" | |
| 51 | + android:launchMode="singleTask" | |
| 52 | + android:theme="@style/Theme.TransparentWin" > | |
| 53 | + </activity> | |
| 54 | + <activity | |
| 55 | + android:name="com.gumptech.sdk.PaymentActivity" | |
| 56 | + android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 57 | + android:launchMode="singleTask" | |
| 58 | + android:theme="@android:style/Theme.Translucent.NoTitleBar" > | |
| 59 | + <intent-filter> | |
| 60 | + <category android:name="android.intent.category.DEFAULT" /> | |
| 61 | + <action android:name="android.intent.action.VIEW" /> | |
| 62 | + <category android:name="android.intent.category.BROWSABLE" /> | |
| 63 | + <data | |
| 64 | + android:host="com.gump.sdk" | |
| 65 | + android:scheme="gump+游戏的appId" /> | |
| 66 | + </intent-filter> | |
| 67 | + </activity> | |
| 68 | + <activity | |
| 69 | + android:name="com.gumptech.sdk.ExchangeWindow" | |
| 70 | + android:configChanges="orientation|screenSize|keyboardHidden|keyboard|screenLayout" | |
| 71 | + android:theme="@style/Theme.WinForExchange" > | |
| 72 | + </activity> | |
| 73 | + | |
| 74 | + <service android:name="com.gumptech.sdk.PushService" /> | |
| 75 | + | |
| 76 | + <!-- vk登录使用，若不接入vk，不需配置 --> | |
| 77 | + <activity android:name="com.vk.sdk.VKOpenAuthActivity" /> | |
| 78 | + <activity | |
| 79 | + android:name="com.vk.sdk.VKServiceActivity" | |
| 80 | + android:label="ServiceActivity" | |
| 81 | + android:theme="@style/VK.Transparent" /> | |
| 82 | + <!--wechat接入使用，不接入不需要配置--> | |
| 83 | + <activity | |
| 84 | + android:name=".wxapi.WXEntryActivity" | |
| 85 | + android:exported="true"></activity> | |
| 86 | + | |
| 87 | +### 3.向Gump平台索要游戏ID（AppID），完成代码接入 | |
| 88 | +正式开始接入逻辑代码前,先介绍下一些附加设置,以方便代码接入 | |
| 89 | + | |
| 90 | +*是否打印debug日志 | |
| 91 | + | |
| 92 | + GumpSDK.getSettings().enableDebugLogging(true); | |
| 93 | + | |
| 94 | +*横竖屏控制,默认为横屏,参数为false即为竖屏 | |
| 95 | + | |
| 96 | + GumpSDK.getSettings().setScreenLandscape(true); | |
| 97 | + | |
| 98 | +*设置需要启用的第三方登录，参数可选类型见第二章：[第三方登录平台](http://repository.gumptech.com:81/document/gamesdk4-android/blob/master/IntegrationGuide.md#1-third_plat) 字段说明 | |
| 99 | + | |
| 100 | + GumpSDK.getSettings().requestThirdSupport(SDKSettings.THIRD_SUPPORT_*)； | |
| 101 | + | |
| 102 | +*若要使用V4版支付请设置 | |
| 103 | + | |
| 104 | + GumpSDK.getSettings().setPaymentVersion(PaymentVersion.V4); | |
| 105 | + | |
| 106 | +#### 1.调用GumpSDK前需要执行初始化。 | |
| 107 | + | |
| 108 | +若不需要分渠道 | |
| 109 | + | |
| 110 | + GumpSDK.init(Context,Appid, Appkey,InitializeCallback); | |
| 111 | +如果需要定义渠道,必须使用如下方法 | |
| 112 | + | |
| 113 | + GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback); | |
| 114 | + | |
| 115 | +InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败 | |
| 116 | + | |
| 117 | +#### 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 | |
| 118 | + | |
| 119 | + GumpSDK.start(Activity); | |
| 120 | +在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下: | |
| 121 | + | |
| 122 | + GumpSDK.setUserStateListener(new LoginStateListener() { | |
| 123 | + @Override | |
| 124 | + public void onLoginSuccess(GumpUser gumpUser) { | |
| 125 | + //登录成功,用户信息包含在GumpUser对象里 | |
| 126 | + } | |
| 127 | + | |
| 128 | + @Override | |
| 129 | + public void onLoginFailed(int code, String msg) { | |
| 130 | + //登录出错,根据错误码和信息判断错误类型 | |
| 131 | + Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show(); | |
| 132 | + } | |
| 133 | + | |
| 134 | + @Override | |
| 135 | + public void onLoginCanceled() { | |
| 136 | + //用户取消登录 | |
| 137 | + Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show(); | |
| 138 | + } | |
| 139 | + | |
| 140 | + @Override | |
| 141 | + public void onLogout() { | |
| 142 | + //用户登出 | |
| 143 | + | |
| 144 | + } | |
| 145 | + @Override | |
| 146 | + public void onPermissionDenied() { | |
| 147 | + //用户拒绝授予权限 | |
| 148 | + } | |
| 149 | + }); | |
| 150 | + | |
| 151 | +如上成功登录后收到的GumpUser对象包含以下信息 | |
| 152 | + | |
| 153 | + gumpUser.getUid();//获取用户的userid,此Id标识唯一用户! | |
| 154 | + gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取 | |
| 155 | + gumpUser.getSessionKey();//登录的sessionKey对象,获取sessionKey字符串请使用此对象的getToken()方法 | |
| 156 | + | |
| 157 | +***注意：若需要使用微信登录，需要在packageName.wxapi下增加一个名为WXEntryActivity并继承com.gumptech.sdk.WXCallbackActivity的Activity，并参考AndroidManifest.xml设置的说明，做相应的配置，packageName为应用的包名，此Activity不须任何实现。*** | |
| 158 | + | |
| 159 | +***以GumpSDKDemo为例，包名为com.gumptech.sdk.demo，则WXEntryActivity的完整包路径为：com.gumptech.sdk.demo.wxapi.WXEntryActivity*** | |
| 160 | + | |
| 161 | +#### 3.支付功能 | |
| 162 | +1)使用gump通行证登录,其中除nick外所有参数为必传参数 | |
| 163 | + | |
| 164 | + Bundle payInfo = new Bundle(); | |
| 165 | + payInfo.putString("nick", "thi"); | |
| 166 | + payInfo.putString("product", "元宝"); | |
| 167 | + payInfo.putFloat("amount", 40.0f); | |
| 168 | + payInfo.putString("extraInfo", "This is demo!"); | |
| 169 | + payInfo.putString("serverId", "B4003"); | |
| 170 | + payInfo.putString("roleId", "10010"); | |
| 171 | + payInfo.putString("sessionKey","sessionkey"); | |
| 172 | + GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback); | |
| 173 | +调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含,其中sessionKey为登录时返回的sessionKey | |
| 174 | + | |
| 175 | + | |
| 176 | +2)IAP支付 | |
| 177 | + | |
| 178 | + Bundle payInfo = new Bundle(); | |
| 179 | + payInfo.putString("product", "gp_skuId"); | |
| 180 | + payInfo.putFloat("amount", 0.1f); | |
| 181 | + payInfo.putString("extraInfo", "This is demo!"); | |
| 182 | + payInfo.putString("serverId", "100"); | |
| 183 | + payInfo.putString("roleId","100123"); | |
| 184 | + GumpSDK.iap(MainActivity.this, payInfo, PurchaseCallback); | |
| 185 | + | |
| 186 | +3)PurchaseCallback为支付状态回调接口,此接口含有3个方法 | |
| 187 | + | |
| 188 | + @Override | |
| 189 | + public void onPurchaseCompleted(PurchaseResult result) { | |
| 190 | + Log.i(TAG,"purchase completed"); | |
| 191 | + } | |
| 192 | + | |
| 193 | + @Override | |
| 194 | + public void onPurchaseError(int code, String msg) { | |
| 195 | + Log.i(TAG,"purchase error"); | |
| 196 | + } | |
| 197 | + | |
| 198 | + @Override | |
| 199 | + public void onPurchaseCanceled() { | |
| 200 | + Log.i(TAG,"purchase canceled"); | |
| 201 | + } | |
| 202 | + | |
| 203 | +#### 4.注销登录 | |
| 204 | + | |
| 205 | + GumpSDK.logout(Activity); | |
| 206 | +当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序!为了便于用户切换登录账户,请在游戏内提供用户注销的触发按钮 | |
| 207 | +#### 5.运营开关接口，若需要接入，会有我方运营人员提出需求，否则不需要接入（若对此接口不知所云，即可认为不需要接入，请自行忽略） | |
| 208 | + | |
| 209 | + GumpSDK.checkRisk(this, new ResultCallback() { | |
| 210 | + @Override | |
| 211 | + public void onResult(boolean result) { | |
| 212 | + Log.i(TAG,result?"There is some risks":"Nothing is risk"); | |
| 213 | + } | |
| 214 | + }); | |
| 215 | + | |
| 216 | +## 第二章 常量字段与代码 | |
| 217 | +### 1.第三方登录平台(third_plat) | |
| 218 | + | 常量字段 | 说明 | | |
| 219 | + |--------------------------------|--------------| | |
| 220 | + |SDKSettings.THIRD_SUPPORT_FB |Facebook登录 | | |
| 221 | + |SDKSettings.THIRD_SUPPORT_GOOGLE|Google登录 | | |
| 222 | + |SDKSettings.THIRD_SUPPORT_LINE |Line登录 | | |
| 223 | + |SDKSettings.THIRD_SUPPORT_VK |VK登录 | | |
| 224 | + |SDKSettings.THIRD_SUPPORT_WECHAT|微信登录 | | |
| 225 | +### 2.登录账户类型 | |
| 226 | + | 常量字段 | 说明 | | |
| 227 | + |-------------------------------------|-------------| | |
| 228 | + |GumpPreference.ACCOUNT_TYPE_FB |Facebook用户 | | |
| 229 | + |GumpPreference.ACCOUNT_TYPE_REG |Gump注册用户 | | |
| 230 | + |GumpPreference.ACCOUNT_TYPE_QUICK_REG|快速注册用户 | | |
| 231 | + |GumpPreference.ACCOUNT_TYPE_GOOGLE |Google用户 | | |
| 232 | + |GumpPreference.ACCOUNT_TYPE_LINE |Line用户 | | |
| 233 | + |GumpPreference.ACCOUNT_TYPE_VK |VK用户 | | |
| 234 | + |GumpPreference.ACCOUNT_TYPE_WECHAT |微信用户 | | |
| 235 | + | |
| 236 | +## 第三章 常见问题 | |
| 237 | +### 问题1： 如何避免混淆对SDK的影响？ | |
| 238 | +解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java | |
| 239 | +类，导致SDK无法正常工作，解决方法如下: | |
| 240 | +Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 | |
| 241 | + | |
| 242 | + -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable | |
| 243 | + -keep public class * extends android.app.Service | |
| 244 | + -keep public class com.google.vending.licensing.ILicensingService | |
| 245 | + -keep public class com.android.vending.licensing.ILicensingService | |
| 246 | + -keep class com.gumptech.sdk.view.* {*;} | |
| 247 | + -keep class com.gumptech.sdk.web.* {*;} | |
| 248 | + -keep class com.gumptech.sdk.bridge.impl.*{*;} | |
| 249 | + | |
| 250 | + | |
| 251 | +使得混淆的时候不会影响SDK的命名空间。 | |
| 0 | 252 | \ No newline at end of file |