Commit d95d6c5fd858d40805e7f0a47229405c50103731
Exists in
master
Merge branch 'master' of http://git.letsgame.mobi/document/gumptech-document
Showing 6 changed files Inline Diff
doc/AndroidDocument.md
1 | # Gump Android SDK使用文档 | 1 | # Gump Android SDK使用文档 |
2 | 2 | ||
3 | 3 | ||
4 | 接入手册 | 4 | 接入手册 |
5 | V 2.3.1 | 5 | V 2.3.1 |
6 | 2015年01月08日 | 6 | 2015年01月08日 |
7 | 7 | ||
8 | 快速入口: | 8 | 快速入口: |
9 | [支付部分服务端回调文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/ServerDocument.md) | 9 | [支付部分服务端回调文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/ServerDocument.md) |
10 | 10 | ||
11 | ## 目录 | 11 | ## 目录 |
12 | 12 | ||
13 | * [第一章 接入指南](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) | 13 | * [第一章 接入指南](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) |
14 | - [1. 导入资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1) | 14 | - [1. 导入资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1) |
15 | - [2. 添加资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2) | 15 | - [2. 添加资源工程](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2) |
16 | - [3. 代码实现](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#3) | 16 | - [3. 代码实现](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#3) |
17 | > [1.修改AndroidManifest.xml文件](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-androidmanifest-xml) | 17 | > [1.修改AndroidManifest.xml文件](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-androidmanifest-xml) |
18 | > [2.向Gump平台索要游戏ID(GID),完成代码接入](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2-gump-id-gid) | 18 | > [2.向Gump平台索要游戏ID(GID),完成代码接入](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#2-gump-id-gid) |
19 | * [第二章 常见问题](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) | 19 | * [第二章 常见问题](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#) |
20 | - [问题1: 如何避免混淆对SDK的影响?](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-sdk) | 20 | - [问题1: 如何避免混淆对SDK的影响?](http://git.letsgame.mobi/document/gumptech-document/blob/master/AndroidDocument.md#1-sdk) |
21 | - [问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错?](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/AndroidDocument.md#2-ok) | 21 | - [问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错?](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/AndroidDocument.md#2-ok) |
22 | 22 | ||
23 | 23 | ||
24 | 24 | ||
25 | 25 | ||
26 | ## 第一章 接入指南 | 26 | ## 第一章 接入指南 |
27 | 配置环境 | 27 | 配置环境 |
28 | 28 | ||
29 | 本接口API 适用于Android2.2以上各版本Android平台。 | 29 | 本接口API 适用于Android2.2以上各版本Android平台。 |
30 | ### 1. 导入资源工程 | 30 | ### 1. 导入资源工程 |
31 | 1.将LoginSDK资源工程拷贝到工作空间,在eclipse中的导航栏右键弹出如图1画面,选择Import导入资源工程,如图1. | 31 | 1.将LoginSDK资源工程拷贝到工作空间,在eclipse中的导航栏右键弹出如图1画面,选择Import导入资源工程,如图1. |
32 | 32 | ||
33 |  | 33 |  |
34 | 图1 | 34 | 图1 |
35 | 35 | ||
36 | 2.导入工程后,右键此工程,在Properties->Android中选中此工程为library工程(勾选红色方框标识处)如图2。 | 36 | 2.导入工程后,右键此工程,在Properties->Android中选中此工程为library工程(勾选红色方框标识处)如图2。 |
37 |  | 37 |  |
38 | 图 2 | 38 | 图 2 |
39 | ### 2. 添加资源工程 | 39 | ### 2. 添加资源工程 |
40 | 添加资源工程为游戏项目的 library。右键游戏项目,在Properties->Android中点击Add添加资源工程为项目工程的library,结果如图3。 | 40 | 添加资源工程为游戏项目的 library。右键游戏项目,在Properties->Android中点击Add添加资源工程为项目工程的library,结果如图3。 |
41 |  | 41 |  |
42 | 图 3 | 42 | 图 3 |
43 | 43 | ||
44 | 44 | ||
45 | 注意:如果ADT版本低于14,ADT不支持jar包自动引入,请手动拷贝libs到您的工作 | 45 | 注意:如果ADT版本低于14,ADT不支持jar包自动引入,请手动拷贝libs到您的工作 |
46 | 空间。 | 46 | 空间。 |
47 | 47 | ||
48 | Eclipse查看ADT版本号的方法: | 48 | Eclipse查看ADT版本号的方法: |
49 | Help==>About Eclips点击Android对应的图标就可以查看版本了. | 49 | Help==>About Eclips点击Android对应的图标就可以查看版本了. |
50 | 如图,红色框部分就是ADT版本号。 | 50 | 如图,红色框部分就是ADT版本号。 |
51 | 51 | ||
52 |  | 52 |  |
53 | 53 | ||
54 | 54 | ||
55 | ### 3. 代码实现 | 55 | ### 3. 代码实现 |
56 | #### 1、 修改AndroidManifest.xml文件 | 56 | #### 1、 修改AndroidManifest.xml文件 |
57 | 首先添加必要的权限,如下所示: | 57 | 首先添加必要的权限,如下所示: |
58 | 58 | ||
59 | <uses-permission android:name="android.permission.INTERNET" /> | 59 | <uses-permission android:name="android.permission.INTERNET" /> |
60 | <uses-permission android:name="android.permission.READ_PHONE_STATE" /> | 60 | <uses-permission android:name="android.permission.READ_PHONE_STATE" /> |
61 | <uses-permission android:name="android.permission.BLUETOOTH" /> | 61 | <uses-permission android:name="android.permission.BLUETOOTH" /> |
62 | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> | 62 | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> |
63 | <uses-permission android:name="android.permission.WRITE_SETTINGS"/> | 63 | <uses-permission android:name="android.permission.WRITE_SETTINGS"/> |
64 | <uses-permission android:name="android.permission.GET_ACCOUNTS"/> | 64 | <uses-permission android:name="android.permission.GET_ACCOUNTS"/> |
65 | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 65 | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> |
66 | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | 66 | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> |
67 | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 67 | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> |
68 | 68 | ||
69 | <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> | 69 | <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> |
70 | <uses-permission android:name="com.android.vending.BILLING" /> | 70 | <uses-permission android:name="com.android.vending.BILLING" /> |
71 | 71 | ||
72 | 其次注册相应的Activity,具体如下: | 72 | 其次注册相应的Activity,具体如下: |
73 | 73 | ||
74 | <activity | 74 | <activity |
75 | android:name="com.gumptech.sdk.ContainerActivity" | 75 | android:name="com.gumptech.sdk.ContainerActivity" |
76 | android:theme="@style/container_dialog" | 76 | android:theme="@style/container_dialog" |
77 | android:configChanges="orientation|screenLayout" > | 77 | android:configChanges="orientation|screenLayout" > |
78 | </activity> | 78 | </activity> |
79 | <activity | 79 | <activity |
80 | android:name="com.facebook.LoginActivity" | 80 | android:name="com.facebook.LoginActivity" |
81 | android:theme="@android:style/Theme.Translucent.NoTitleBar" > | 81 | android:theme="@android:style/Theme.Translucent.NoTitleBar" > |
82 | </activity> | 82 | </activity> |
83 | <activity | 83 | <activity |
84 | android:name="com.gumptech.sdk.PaymentActivity" | 84 | android:name="com.gumptech.sdk.PaymentActivity" |
85 | android:configChanges="orientation|screenLayout" | 85 | android:configChanges="orientation|screenLayout" |
86 | android:theme="@android:style/Theme.Translucent.NoTitleBar" > | 86 | android:theme="@android:style/Theme.Translucent.NoTitleBar" > |
87 | </activity> | 87 | </activity> |
88 | <activity | 88 | <activity |
89 | android:name="com.gumptech.sdk.ExchangeWindow" | 89 | android:name="com.gumptech.sdk.ExchangeWindow" |
90 | android:configChanges="orientation|screenLayout" | 90 | android:configChanges="orientation|screenLayout" |
91 | android:theme="@style/ex_win" > | 91 | android:theme="@style/ex_win" > |
92 | </activity> | 92 | </activity> |
93 | <service android:name="com.gumptech.sdk.PushService" > | 93 | <service android:name="com.gumptech.sdk.PushService" > |
94 | </service> | 94 | </service> |
95 | 95 | ||
96 | 96 | ||
97 | #### 2、 向Gump平台索要游戏ID(GID),完成代码接入 | 97 | #### 2、 向Gump平台索要游戏ID(GID),完成代码接入 |
98 | 1.调用GumpSDK前需要执行初始化。 | 98 | 1.调用GumpSDK前需要执行初始化。 |
99 | 若不需要分渠道 | 99 | 若不需要分渠道 |
100 | 100 | ||
101 | GumpSDK.init(Context,Appid, Appkey); | 101 | GumpSDK.init(Context,Appid, Appkey); |
102 | 如果需要定义渠道,必须使用如下方法 | 102 | 如果需要定义渠道,必须使用如下方法 |
103 | 103 | ||
104 | GumpSDK.init(Context,Appid, Appkey,ChannelId); | 104 | GumpSDK.init(Context,Appid, Appkey,ChannelId); |
105 | *gump logo的显示控制方法,此方法参数指定是否显示GumpLogo | 105 | *gump logo的显示控制方法,此方法参数指定是否显示GumpLogo |
106 | 106 | ||
107 | GumpSDK.setShowLogo(boolean); | 107 | GumpSDK.setShowLogo(boolean); |
108 | *横竖屏控制,默认为横屏,参数为false即为竖屏 | 108 | *横竖屏控制,默认为横屏,参数为false即为竖屏 |
109 | 109 | ||
110 | GumpSDK.setScreenLandscape(true); | 110 | GumpSDK.setScreenLandscape(true); |
111 | 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 | 111 | 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 |
112 | 112 | ||
113 | GumpSDK.start(Activity); | 113 | GumpSDK.start(Activity); |
114 | 开发者需要在调用的Activity里重写onActivityResult方法以接受用户的登录结果,通常如下: | 114 | 开发者需要在调用的Activity里重写onActivityResult方法以接受用户的登录结果,通常如下: |
115 | 115 | ||
116 | //登录请求返回结果 | 116 | //登录请求返回结果 |
117 | if (requestCode == GumpSDK.LOGIN_REQUEST_CODE) { | 117 | if (requestCode == GumpSDK.LOGIN_REQUEST_CODE) { |
118 | if (resultCode == RESULT_OK) { | 118 | if (resultCode == RESULT_OK) { |
119 | String uid = data.getIntExtra("userId", -1); | 119 | String uid = data.getIntExtra("userId", -1); |
120 | int accountType = data.getIntExtra("accountType", -1); | 120 | int accountType = data.getIntExtra("accountType", -1); |
121 | String sessionkey = data.getStringExtra("sessionKey"); | 121 | String sessionkey = data.getStringExtra("sessionKey"); |
122 | 122 | ||
123 | } else if (resultCode == RESULT_CANCELED) { | 123 | } else if (resultCode == RESULT_CANCELED) { |
124 | Toast.makeText(this, "operate be canceled", Toast.LENGTH_SHORT).show(); | 124 | Toast.makeText(this, "operate be canceled", Toast.LENGTH_SHORT).show(); |
125 | } | 125 | } |
126 | } | 126 | } |
127 | 127 | ||
128 | 如上将收到成功登录用的userid,此Id标识唯一用户! | 128 | 如上将收到成功登录用的userid,此Id标识唯一用户! |
129 | 129 | ||
130 | 3.支付功能 | 130 | 3.支付功能 |
131 | 1)使用gump通行证登录 | 131 | 1)使用gump通行证登录,其中serverId为必传参数 |
132 | 132 | ||
133 | Bundle payInfo = new Bundle(); | 133 | Bundle payInfo = new Bundle(); |
134 | payInfo.putString("nick", "thi"); | 134 | payInfo.putString("nick", "thi"); |
135 | payInfo.putString("product", "元宝"); | 135 | payInfo.putString("product", "元宝"); |
136 | payInfo.putFloat("amount", 40.0f); | 136 | payInfo.putFloat("amount", 40.0f); |
137 | payInfo.putString("extraInfo", "This is demo!"); | 137 | payInfo.putString("extraInfo", "This is demo!"); |
138 | payInfo.putString("serverId", "B4003"); | 138 | payInfo.putString("serverId", "B4003"); |
139 | payInfo.putString("roleId", "10010"); | 139 | payInfo.putString("roleId", "10010"); |
140 | GumpSDK.pay(MainActivity.this, payInfo); | 140 | GumpSDK.pay(MainActivity.this, payInfo); |
141 | 调用pay方法时,必须穿入一个bundle对象,包含如上字段,可以设置值为空,但是字段必须全部包含,支付完成仍然通过onActivityResult回调,requestCode为GumpSDK.PAY_REQUEST_CODE,回调信息除code和msg外,还含有orderId和传入的extraInfo. | 141 | 调用pay方法时,必须穿入一个bundle对象,包含如上字段,除serverId外可以设置值为空,但是字段必须全部包含 |
142 | 2)未使用gump通行证登录,需要传入用户id | 142 | 2)未使用gump通行证登录,需要传入用户id,serverId为必传参数 |
143 | 143 | ||
144 | Bundle payInfo = new Bundle(); | 144 | Bundle payInfo = new Bundle(); |
145 | payInfo.putString("nick", "thi"); | 145 | payInfo.putString("nick", "thi"); |
146 | payInfo.putString("product", "元宝"); | 146 | payInfo.putString("product", "元宝"); |
147 | payInfo.putFloat("amount", 40.0f); | 147 | payInfo.putFloat("amount", 40.0f); |
148 | payInfo.putString("extraInfo", "This is demo!"); | 148 | payInfo.putString("extraInfo", "This is demo!"); |
149 | payInfo.putString("serverId", "B4003"); | 149 | payInfo.putString("serverId", "B4003"); |
150 | payInfo.putString("roleId", "10010"); | 150 | payInfo.putString("roleId", "10010"); |
151 | GumpSDK.pay(MainActivity.this, payInfo,"1021"); | 151 | GumpSDK.pay(MainActivity.this, payInfo,"1021"); |
152 | 5.注销登录 | 152 | 5.注销登录 |
153 | 153 | ||
154 | GumpSDK.logout(Activity,GumpSDK.Callback); | 154 | GumpSDK.logout(Activity,GumpSDK.Callback); |
155 | 当此方法调用后,用户退出登录,并会通过callback接口通知调用程序! | 155 | 当此方法调用后,用户退出登录,并会通过callback接口通知调用程序! |
156 | ## 第二章 常见问题 | 156 | ## 第二章 常见问题 |
157 | ### 问题1: 如何避免混淆对SDK的影响? | 157 | ### 问题1: 如何避免混淆对SDK的影响? |
158 | 解答:有些开发者对接入了SDK的程序进行混淆时,有可能会覆盖某些java | 158 | 解答:有些开发者对接入了SDK的程序进行混淆时,有可能会覆盖某些java |
159 | 类,导致SDK无法正常工作,解决方法如下: | 159 | 类,导致SDK无法正常工作,解决方法如下: |
160 | Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 | 160 | Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 |
161 | 161 | ||
162 | -keepattributes *Annotation* | 162 | -keepattributes *Annotation* |
163 | -keep public class * extends android.app.Service | 163 | -keep public class * extends android.app.Service |
164 | -keep public class com.google.vending.licensing.ILicensingService | 164 | -keep public class com.google.vending.licensing.ILicensingService |
165 | -keep public class com.android.vending.licensing.ILicensingService | 165 | -keep public class com.android.vending.licensing.ILicensingService |
166 | -keep class com.gumptech.sdk.view.* {*;} | 166 | -keep class com.gumptech.sdk.view.* {*;} |
167 | -keep class com.gumptech.sdk.web.* {*;} | 167 | -keep class com.gumptech.sdk.web.* {*;} |
168 | -keep class com.gumptech.sdk.GumpSDK$Callback{ | 168 | -keep class com.gumptech.sdk.GumpSDK$Callback{ |
169 | void onLogout(); | 169 | void onLogout(); |
170 | } | 170 | } |
171 | -keep class com.gumptech.sdk.GumpPreference{ | 171 | -keep class com.gumptech.sdk.GumpPreference{ |
172 | public static final <fields>; | 172 | public static final <fields>; |
173 | } | 173 | } |
174 | 174 | ||
175 | 使得混淆的时候不会影响SDK的命名空间。 | 175 | 使得混淆的时候不会影响SDK的命名空间。 |
176 | ### 问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错? | 176 | ### 问题2:后台已经配置ok的情况下,支付列表仍然为空或登录总是出错? |
177 | 解答:sdk在debug模式下使用的默认服务器地址是开发环境地址,此地址区别于正式环境地址,为开发调试用;若进行线上调试或正式环境测试,需要使用release模式来进行! | 177 | 解答:sdk在debug模式下使用的默认服务器地址是开发环境地址,此地址区别于正式环境地址,为开发调试用;若进行线上调试或正式环境测试,需要使用release模式来进行! |
178 | 一般在IDE中直接run应用到设备上使用的是debug证书安装,此时即处于debug模式;若要使用正式环境,应该使用正式证书签名打包后进行安装! | 178 | 一般在IDE中直接run应用到设备上使用的是debug证书安装,此时即处于debug模式;若要使用正式环境,应该使用正式证书签名打包后进行安装! |
doc/IOSDocument.md
1 | # Gump IOS SDK使用文档 | 1 | # Gump IOS SDK使用文档 |
2 | 2 | ||
3 | 3 | ||
4 | 接入手册 | 4 | 接入手册 |
5 | V | 5 | V |
6 | 2015年02月13日 | 6 | 2015年02月13日 |
7 | 7 | ||
8 | 8 | ||
9 | 9 | ||
10 | ## 1、添加动态库 | 10 | ## 1、添加动态库 |
11 | 在工程里添加MobileCoreServices.framework、SystemConfiguration.framework、libz.dylib、CFNetwork.framework、libletsgame.a | 11 | 在工程里添加MobileCoreServices.framework、SystemConfiguration.framework、libz.dylib、CFNetwork.framework、libletsgame.a |
12 | 12 | ||
13 | 13 | ||
14 | ## 2、设置头文件搜索路径 | 14 | ## 2、设置头文件搜索路径 |
15 | 头文件只有LetsGameAPI.h和LSGAccount.h两个文件,引入头文件,并设置搜索路径。 | 15 | 头文件只有LetsGameAPI.h和LSGAccount.h两个文件,引入头文件,并设置搜索路径。 |
16 | 16 | ||
17 | 17 | ||
18 | ## 3、添加资源文件 | 18 | ## 3、添加资源文件 |
19 | 在工程里添加letsgame.bundle资源文件,里面包含图片及相关语言包 | 19 | 在工程里添加letsgame.bundle资源文件,里面包含图片及相关语言包 |
20 | 20 | ||
21 | 21 | ||
22 | ## 4、在工程里添加SDK登录代码 | 22 | ## 4、在工程里添加SDK登录代码 |
23 | 23 | ||
24 | [LetsGameAPI instance].appId = @"100"; // 设置appId | 24 | [LetsGameAPI instance].appId = @"100"; // 设置appId |
25 | [LetsGameAPI instance].appKey = @"100"; // 设置appKey | 25 | [LetsGameAPI instance].appKey = @"100"; // 设置appKey |
26 | 26 | ||
27 | [[LetsGameAPI instance] showLoginView]; // 弹出登录页面 | 27 | [[LetsGameAPI instance] showLoginView]; // 弹出登录页面 |
28 | 28 | ||
29 | // 登录成功回调 | 29 | // 登录成功回调 |
30 | [LetsGameAPI instance].succBlock = ^(NSString *userId, NSString *sessionKey, LSGAccountType type) { | 30 | [LetsGameAPI instance].succBlock = ^(NSString *userId, NSString *sessionKey, LSGAccountType type) { |
31 | NSLog(@"%@", [NSString stringWithFormat:@"login succ: userId = %@, sessionKey = %@, accountType = %d", userId, sessionKey, type]); | 31 | NSLog(@"%@", [NSString stringWithFormat:@"login succ: userId = %@, sessionKey = %@, accountType = %d", userId, sessionKey, type]); |
32 | }; | 32 | }; |
33 | 33 | ||
34 | // 登录失败回调 | 34 | // 登录失败回调 |
35 | [LetsGameAPI instance].dismissBlock = ^() { | 35 | [LetsGameAPI instance].dismissBlock = ^() { |
36 | NSLog(@"dismiss without login"); | 36 | NSLog(@"dismiss without login"); |
37 | }; | 37 | }; |
38 | 38 | ||
39 | 39 | ||
40 | ## 5、支付 | 40 | ## 5、支付 |
41 | [LetsGameAPI instance].appId = @"10022"; | 41 | [LetsGameAPI instance].appId = @"10022"; |
42 | [LetsGameAPI instance].appKey = @"f899139df5e1059396431415e770c6dd"; | 42 | [LetsGameAPI instance].appKey = @"f899139df5e1059396431415e770c6dd"; |
43 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; | 43 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; |
44 | [payInfo setValue:@"5001" forKey:@"serverId"];//服务器id | 44 | [payInfo setValue:@"5001" forKey:@"serverId"];//服务器id,必传参数 |
45 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id | 45 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id |
46 | [payInfo setValue:@"10" forKey:@"amount"];//金额 | 46 | [payInfo setValue:@"10" forKey:@"amount"];//金额 |
47 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//外部订单信息 | 47 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//外部订单信息 |
48 | [payInfo setValue:@"元宝" forKey:@"product"];//物品信息 | 48 | [payInfo setValue:@"元宝" forKey:@"product"];//物品信息 |
49 | [[LetsGameAPI instance] pay:payInfo]; | ||
50 |
doc/ServerDocument.md
1 | ## GumpTech服务端接口文档 | 1 | ## GumpTech服务端接口文档 |
2 | 2 | ||
3 | 1. 用户登录验证接口 | 3 | 1. 用户登录验证接口 |
4 | ---------------------------- | 4 | ---------------------------- |
5 | 接口地址:http://api.gumptech.com/v1/user/verify_user.do | 5 | 接口地址:http://api.gumptech.com/v1/user/verify_user.do |
6 | 参数: | 6 | 参数: |
7 | appId: 游戏接入分配appid | 7 | appId: 游戏接入分配appid |
8 | appkey: 注意appkey都为小写字母 | 8 | appkey: 注意appkey都为小写字母 |
9 | userId: GumpTech平台的用户id | 9 | userId: GumpTech平台的用户id |
10 | sessionKey: 登录后回调给给第三方 | 10 | sessionKey: 登录后回调给给第三方 |
11 | 11 | ||
12 | 返回值: | 12 | 返回值: |
13 | { | 13 | { |
14 | "code":100000 | 14 | "code":100000 |
15 | "msg":"xxxxxx" | 15 | "msg":"xxxxxx" |
16 | "data":{ | 16 | "data":{ |
17 | "userId":23444 | 17 | "userId":23444 |
18 | "sessionKey":"xxx" | 18 | "sessionKey":"xxx" |
19 | } | 19 | } |
20 | } | 20 | } |
21 | 21 | ||
22 | 22 | ||
23 | 23 | ||
24 | 2. 充值通知第三方服务端接口 | 24 | 2. 充值通知第三方服务端接口 |
25 | ----------------------------- | 25 | ----------------------------- |
26 | 参数列表: | 26 | 参数列表: |
27 | orderId: 订单id | 27 | orderId: 订单id |
28 | appId: 游戏接入分配appid | 28 | appId: 游戏接入分配appid |
29 | userId: 平台用户id | 29 | userId: 平台用户id |
30 | product: 购买商品名字 | 30 | product: 购买商品名字 |
31 | extraInfo:游戏接入方传入自定义参数,200字符 | 31 | extraInfo:游戏接入方传入自定义参数,200字符 |
32 | currency:币种 exp:USD RMB | 32 | currency:币种 (可忽略) |
33 | amount:支付过程中选中额度,第三方可以忽略此参数 | 33 | amount:支付过程中选中额度,第三方可以忽略此参数 |
34 | realAmount: 最终用户支付的额度 | 34 | realAmount: 最终用户支付的额度 (美元) |
35 | serverId: 第三方区服id | 35 | serverId: 第三方区服id |
36 | roleId: 第三方平台角色id | 36 | roleId: 第三方平台角色id |
37 | subPayGateId: 支付类型id | 37 | subPayGateId: 支付类型id |
38 | sig: 签名 | 38 | sig: 签名 |
39 | 39 | ||
40 | 第三方server端返回值: | 40 | 第三方server端返回值: |
41 | 如果第三方验证成功,则返回字符串:success即可。 | 41 | 如果第三方验证成功,则返回字符串:success即可。 |
42 | 42 | ||
43 | 43 | ||
44 | 3.签名算法 | 44 | 3.签名算法 |
45 | -------------------------------- | 45 | -------------------------------- |
46 | 46 | ||
47 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 | 47 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 |
48 | ```java | 48 | ```java |
49 | 49 | ||
50 | /** | 50 | /** |
51 | * 签名算法 | 51 | * 签名算法 |
52 | * @param request | 52 | * @param request |
53 | * @return | 53 | * @return |
54 | */ | 54 | */ |
55 | public String sig(HttpServletRequest request, String key){ | 55 | public String sig(HttpServletRequest request, String key){ |
56 | 56 | ||
57 | Enumeration names = request.getParameterNames(); | 57 | Enumeration names = request.getParameterNames(); |
58 | SortedSet<String> allParams = Sets.newTreeSet(); | 58 | SortedSet<String> allParams = Sets.newTreeSet(); |
59 | 59 | ||
60 | while (names.hasMoreElements()) { | 60 | while (names.hasMoreElements()) { |
61 | String name = (String) names.nextElement(); | 61 | String name = (String) names.nextElement(); |
62 | if (name.equals("sig")) { | 62 | if (name.equals("sig")) { |
63 | continue; | 63 | continue; |
64 | } | 64 | } |
65 | 65 | ||
66 | try { | 66 | try { |
67 | allParams.add(name + "=" + UriUtils.decode(request.getParameter(name), "utf-8")); | 67 | allParams.add(name + "=" + UriUtils.encode(request.getParameter(name), "utf-8")); |
68 | } catch (UnsupportedEncodingException e) { | 68 | } catch (UnsupportedEncodingException e) { |
69 | e.printStackTrace(); | 69 | e.printStackTrace(); |
70 | } | 70 | } |
71 | } | 71 | } |
72 | 72 | ||
73 | String params = Joiner.on("&").join(allParams)+key; | 73 | String params = Joiner.on("&").join(allParams)+key; |
74 | String computedToken = DigestUtils.md5DigestAsHex(params.getBytes()); | 74 | String computedToken = DigestUtils.md5DigestAsHex(params.getBytes()); |
75 | return computedToken; | 75 | return computedToken; |
76 | } | 76 | } |
77 | ``` | 77 | ``` |
78 | 78 | ||
79 | 79 | ||
80 | 80 | ||
81 | 注意:参数是按字母升序排列 akey=value&bkey=value.... + secretkey | 81 | 注意:参数是按字母升序排列 akey=value&bkey=value.... + secretkey |
82 | 82 | ||
83 | 83 | ||
84 | 4. 错误码对照表 | 84 | 4. 错误码对照表 |
85 | ----------------------------- | 85 | ----------------------------- |
86 | 86 | ||
87 | 100000 : 成功 | 87 | 100000 : 成功 |
88 | 800000 : 应用不存在 | 88 | 800000 : 应用不存在 |
89 | 100010 : 用户密码错误 | 89 | 100010 : 用户密码错误 |
90 | 100011 : 用户已经存在 | 90 | 100011 : 用户已经存在 |
91 | 100012 : 用户不存在 | 91 | 100012 : 用户不存在 |
92 | 100013 : 用户名不能为空 | 92 | 100013 : 用户名不能为空 |
93 | 900000 : 订单不存在 | 93 | 900000 : 订单不存在 |
94 | 900001 : 支付失败 | 94 | 900001 : 支付失败 |
95 | 900003 : sig签名错误 | 95 | 900003 : sig签名错误 |
doc/webpay.md
1 | GumpTech页面支付 | 1 | 以下两个接口需要研发商提供,否则支付的时候会出现"获取支付信息失败"提示 |
2 | ----------------------- | 2 | ---------------------------------- |
3 | 3 | 接口请联系运营人员配置到Gump管理后台 | |
4 | 接入使用方式: | ||
5 | ----------------------- | ||
6 | 请使用浏览器方式嵌套GumpTech支付地址: | ||
7 | |||
8 | 统一支付: http://api.gumptech.com/p/index.do | ||
9 | 需要传入参数: | ||
10 | 1. appId: 必选参数 接入前GumpTeck分配的应用id | ||
11 | 2. userId: 必选参数 GumpTech平台的用户id,如果传入,页面上角色名字字段会自动填写 | ||
12 | 3. serverId: 可选参数 注意次参数为字符串,必须保证跟获取区服列表中serverId值保证一致 | ||
13 | 4. extraInfo: 可选参数 第三方自定义字段,字符200以内,原样回调给第三方。 | ||
14 | 5. product: 可选参数 第三方传入,购买物品 | ||
15 | 6. amount: 可选参数 第三方传入,购买物品所需要的金额(点数) | ||
16 | 4 | ||
17 | 以下参数需要在服务端配置,需要联系接口人配置: | ||
18 | 1. queryRoleUrl: 支付页面显示服务器列表 参考【第三方查询角色接口】 | ||
19 | 2. querySeversUrl: 查询用户角色 格式参考【第三方查询区服列表接口】 | ||
20 | 5 | ||
21 | 第三方查询角色接口 | 6 | 第三方查询角色接口(需要研发商提供) |
22 | ------------------------- | 7 | ------------------------- |
23 | 在接入中传入queryRoleUrl参数,即第三方查询角色接口 | 8 | |
24 | GumpTech调用过程如下: | 9 | GumpTech调用过程如下: |
25 | 请求接口:传入queryRoleUrl的地址 | 10 | 请求接口:queryRoleUrl的地址 |
26 | 请求方式:post | 11 | 请求方式:post |
27 | 参数: | 12 | 参数: |
28 | serverId servers参数json中的serverId的值 | 13 | serverId servers参数json中的serverId的值 |
29 | userId GumpTech用户id | 14 | userId GumpTech用户id |
30 | 返回值: | 15 | 返回值: |
31 | { | 16 | { |
32 | "userId":5104 | 17 | "userId":5104 |
33 | "roleId":5104 | 18 | "roleId":5104 |
34 | "roleName":"卡卡" | 19 | "roleName":"卡卡" |
35 | } | 20 | } |
36 | userId为GumpTech平台的用户id | 21 | userId为GumpTech平台的用户id |
37 | roleId为第三方平台的角色id | 22 | roleId为第三方平台的角色id |
38 | roleName为第三方平台的角色名字 | 23 | roleName为第三方平台的角色名字 |
39 | 24 | ||
40 | 25 | ||
41 | 第三方查询区服列表接口 | 26 | 第三方查询区服列表接口(需要研发商提供) |
42 | ------------------------- | 27 | ------------------------- |
43 | 28 | ||
44 | 在接入中传入querySeversUrl参数,即获取第三方查询角色接口 | 29 | |
45 | 调用过程如下: | 30 | Gump调用过程如下:querySeversUrl的地址 |
46 | 31 | ||
47 | 请求方式:get方式 | 32 | 请求方式:get方式 |
48 | 参数:无 | 33 | 参数:无 |
49 | 返回值: | 34 | 返回值: |
50 | 35 | ||
51 | 字符串格式json串,如下: | 36 | 字符串格式json串,如下: |
52 | [ | 37 | [ |
53 | {"serverId":"s2", "serverName":"测试1"}, | 38 | {"serverId":"s2", "serverName":"测试1"}, |
54 | {"serverId":"s2", "serverName":"测试1"} | 39 | {"serverId":"s2", "serverName":"测试1"} |
55 | ... | 40 | ... |
56 | ] | 41 | ] |
57 | 42 | ||
58 | 43 | ||
59 | 充值成功通知第三方服务端接口 | 44 | 充值成功通知第三方服务端接口 |
60 | ----------------------------- | 45 | ----------------------------- |
61 | 46 | ||
62 | 47 | ||
63 | 请参考[GumpTech服务端文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/ServerDocument.md) | ||
48 | 请参考[GumpTech服务端文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/ServerDocument.md) | ||
49 | |||
50 | |||
51 | |||
52 | |||
53 | |||
54 | GumpTech页面支付(已集成到sdk中,可忽略) | ||
55 | ----------------------- | ||
56 | |||
57 | 接入使用方式: |
ios/ios_sdk_20150603.zip
No preview for this file type
ios/ios_sdk_20150630.zip
No preview for this file type