SDK / GameSDK-Doc

Download as
Browse Code »

Commit 088dc87920d18218e8bdfe1d4712f2dc2350290b

Authored by 赵康
2 parents 1dc97150cf 9e587cdb7a
Exists in master

Merge branch 'master' of http://git.letsgame.mobi/document/gumptech-document

Showing 4 changed files Inline Diff

doc/AndroidDocument.md
Diff comments   View file @ 088dc87
1 # Gump Android SDK使用文档 1 # Gump Android SDK使用文档
2 2
3 3
4 接入手册 4 接入手册
5 V 3.3.0 5 V 3.3.0
6 2015年08月30日 6 2015年08月30日
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.将GameSDK资源工程拷贝到工作空间，在eclipse中的导航栏右键弹出如图1画面，选择Import导入资源工程，如图1. 31 1.将GameSDK资源工程拷贝到工作空间，在eclipse中的导航栏右键弹出如图1画面，选择Import导入资源工程，如图1.
32 注意:本sdk需要使用Facebook sdk for android 4.4.1实现fb登录,请自行导入Facebook SDK
33 注意:本sdk需要使用VK sdk for android实现vk登录,请自行导入此sdk
32 注意:本sdk需要使用Facebook sdk for android 4.4.1实现fb登录,请自行导入Facebook SDK 34
33 注意:本sdk需要使用VK sdk for android实现vk登录,请自行导入此sdk 35 ![](images/1.png)
34 36 图1
35 ![](images/1.png) 37
36 图1 38 2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。
37 39 ![](images/2.png)
38 2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。 40 图 2
39 ![](images/2.png) 41 ### 2. 添加资源工程
40 图 2 42 添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。
41 ### 2. 添加资源工程 43 ![](images/3.png)
42 添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。 44 图 3
43 ![](images/3.png) 45
44 图 3 46
45 47 注意:如果ADT版本低于14，ADT不支持jar包自动引入，请手动拷贝libs到您的工作
46 48 空间。
47 注意:如果ADT版本低于14，ADT不支持jar包自动引入，请手动拷贝libs到您的工作 49
48 空间。 50 Eclipse查看ADT版本号的方法:
49 51 Help==>About Eclips点击Android对应的图标就可以查看版本了.
50 Eclipse查看ADT版本号的方法: 52 如图，红色框部分就是ADT版本号。
51 Help==>About Eclips点击Android对应的图标就可以查看版本了. 53
52 如图，红色框部分就是ADT版本号。 54 ![](images/4.png)
53 55
54 ![](images/4.png) 56
55 57 ### 3. 代码实现
56 58 #### 1、 修改AndroidManifest.xml文件
57 ### 3. 代码实现 59 首先添加必要的权限，如下所示：
58 #### 1、 修改AndroidManifest.xml文件 60
59 首先添加必要的权限，如下所示： 61 <uses-permission android:name="android.permission.INTERNET" />
60 62 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
61 <uses-permission android:name="android.permission.INTERNET" /> 63 <uses-permission android:name="android.permission.BLUETOOTH" />
62 <uses-permission android:name="android.permission.READ_PHONE_STATE" /> 64 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
63 <uses-permission android:name="android.permission.BLUETOOTH" /> 65 <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
64 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 66 <uses-permission android:name="android.permission.GET_ACCOUNTS"/>
65 <uses-permission android:name="android.permission.WRITE_SETTINGS"/> 67 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
66 <uses-permission android:name="android.permission.GET_ACCOUNTS"/> 68 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
67 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 69 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
68 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 70 <uses-permission android:name="android.permission.SEND_SMS"/>
69 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 71
70 <uses-permission android:name="android.permission.SEND_SMS"/> 72 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. -->
71 73 <uses-permission android:name="com.android.vending.BILLING" />
72 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> 74
73 <uses-permission android:name="com.android.vending.BILLING" /> 75 其次注册相应的Activity，具体如下：
74 76
75 其次注册相应的Activity，具体如下： 77 <activity
76 78 android:name="com.gumptech.sdk.ContainerActivity"
77 <activity 79 android:configChanges="orientation|screenLayout"
78 android:name="com.gumptech.sdk.ContainerActivity" 80 android:windowSoftInputMode="stateAlwaysHidden|adjustPan"
81 android:theme="@style/Theme.TransparentWin" >
79 android:theme="@style/container_dialog" 82 </activity>
80 android:configChanges="orientation|screenLayout" > 83 <activity
81 </activity>
82 <activity
83 android:name="com.facebook.LoginActivity"
84 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
85 </activity> 84 android:name="com.gumptech.sdk.PaymentActivity"
86 <activity 85 android:configChanges="orientation|screenLayout"
87 android:name="com.gumptech.sdk.PaymentActivity" 86 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
88 android:configChanges="orientation|screenLayout" 87 </activity>
89 android:theme="@android:style/Theme.Translucent.NoTitleBar" > 88 <activity
90 </activity> 89 android:name="com.gumptech.sdk.ExchangeWindow"
91 <activity 90 android:configChanges="orientation|screenLayout"
92 android:name="com.gumptech.sdk.ExchangeWindow" 91 android:theme="@style/Theme.WinForExchange" >
93 android:configChanges="orientation|screenLayout" 92 </activity>
93
94 android:theme="@style/ex_win" > 94 <service android:name="com.gumptech.sdk.PushService" >
95 </activity> 95 </service>
96 <!-- facebook -->
96 <service android:name="com.gumptech.sdk.PushService" > 97 <activity
97 </service> 98 android:name="com.facebook.FacebookActivity"
98 <activity 99 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
99 android:name="com.facebook.FacebookActivity" 100 android:label="@string/app_name"
100 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" 101 android:theme="@android:style/Theme.Translucent.NoTitleBar" />
102 <!-- vk -->
103 <activity android:name="com.vk.sdk.VKOpenAuthActivity" />
104 <activity
105 android:name="com.vk.sdk.VKServiceActivity"
106 android:label="ServiceActivity"
107 android:theme="@style/VK.Transparent" />
101 android:label="@string/app_name" 108
102 android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 109
103 110 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入
104 111 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入
105 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入 112
106 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入
107
108 *横竖屏控制,默认为横屏,参数为false即为竖屏 113 *横竖屏控制,默认为横屏,参数为false即为竖屏
109 114
110 GumpSDK.setScreenLandscape(true); 115 GumpSDK.setScreenLandscape(true);
111 *debug模式设置 116 *debug模式设置
112 117
113 GumpSDK.setDebugState(true); 118 GumpSDK.setDebugState(true);
119
120 *设置是否启用Facebook登录和VK登录
121
122 GumpSDK.setFBEnable(true);
123 GumpSDK.setVKEnable(true);
114 124 1.调用GumpSDK前需要执行初始化。
115 *设置是否启用Facebook登录和VK登录 125
116 126 若不需要分渠道
117 GumpSDK.setFBEnable(true); 127
118 GumpSDK.setVKEnable(true); 128 GumpSDK.init(Context,Appid, Appkey,InitializeCallback);
119 1.调用GumpSDK前需要执行初始化。 129 如果需要定义渠道,必须使用如下方法
120 130
121 若不需要分渠道 131 GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback);
122 132
123 GumpSDK.init(Context,Appid, Appkey,InitializeCallback); 133 InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败
124 如果需要定义渠道,必须使用如下方法 134
125 135 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数
126 GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback); 136
127 137 GumpSDK.start(Activity);
128 InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败 138 在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下:
129 139
130 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 140 GumpSDK.setUserStateListener(new LoginStateListener() {
131 141 @Override
132 GumpSDK.start(Activity); 142 public void onLoginSuccess(GumpUser gumpUser) {
133 在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下: 143 //登录成功,用户信息包含在GumpUser对象里
134 144 }
135 GumpSDK.setUserStateListener(new LoginStateListener() { 145
136 @Override 146 @Override
137 public void onLoginSuccess(GumpUser gumpUser) { 147 public void onLoginFailed(int code, String msg) {
138 //登录成功,用户信息包含在GumpUser对象里 148 //登录出错,根据错误码和信息判断错误类型
139 } 149 Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show();
140 150 }
141 @Override 151
142 public void onLoginFailed(int code, String msg) { 152 @Override
143 //登录出错,根据错误码和信息判断错误类型 153 public void onLoginCanceled() {
144 Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show(); 154 //用户取消登录
145 } 155 Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show();
146 156 }
147 @Override 157
148 public void onLoginCanceled() { 158 @Override
149 //用户取消登录 159 public void onLogout() {
150 Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show(); 160 //用户登出
151 } 161
152 162 }
153 @Override 163 });
154 public void onLogout() { 164
155 //用户登出 165 如上成功登录后收到的GumpUser对象包含以下信息
156 166
157 } 167 gumpUser.getUid();//获取用户的userid,此Id标识唯一用户!
158 }); 168 gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取
159 169 gumpUser.getSessionKey();//登录的sesionKey
160 如上成功登录后收到的GumpUser对象包含以下信息 170
161 171
162 gumpUser.getUid();//获取用户的userid,此Id标识唯一用户! 172 3.支付功能
163 gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取 173 1)使用gump通行证登录,其中除nick外所有参数为必传参数
164 gumpUser.getSessionKey();//登录的sesionKey 174
165 175 Bundle payInfo = new Bundle();
166 176 payInfo.putString("nick", "thi");
167 3.支付功能 177 payInfo.putString("product", "元宝");
168 1)使用gump通行证登录,其中除nick外所有参数为必传参数 178 payInfo.putFloat("amount", 40.0f);
169 179 payInfo.putString("extraInfo", "This is demo!");
170 Bundle payInfo = new Bundle(); 180 payInfo.putString("serverId", "B4003");
171 payInfo.putString("nick", "thi"); 181 payInfo.putString("roleId", "10010");
172 payInfo.putString("product", "元宝"); 182 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback);
173 payInfo.putFloat("amount", 40.0f); 183 调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含
174 payInfo.putString("extraInfo", "This is demo!"); 184 2)未使用gump通行证登录,需要传入用户id
175 payInfo.putString("serverId", "B4003"); 185
176 payInfo.putString("roleId", "10010"); 186 Bundle payInfo = new Bundle();
177 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback); 187 payInfo.putString("nick", "thi");
178 调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含 188 payInfo.putString("product", "元宝");
179 2)未使用gump通行证登录,需要传入用户id 189 payInfo.putFloat("amount", 40.0f);
180 190 payInfo.putString("extraInfo", "This is demo!");
181 Bundle payInfo = new Bundle(); 191 payInfo.putString("serverId", "B4003");
182 payInfo.putString("nick", "thi"); 192 payInfo.putString("roleId", "10010");
183 payInfo.putString("product", "元宝"); 193 GumpSDK.pay(MainActivity.this, payInfo,userId,PurchaseCallback);
184 payInfo.putFloat("amount", 40.0f); 194
185 payInfo.putString("extraInfo", "This is demo!"); 195 PurchaseCallback为支付状态回调接口,此接口含有3个方法
186 payInfo.putString("serverId", "B4003"); 196
187 payInfo.putString("roleId", "10010"); 197 @Override
188 GumpSDK.pay(MainActivity.this, payInfo,userId,PurchaseCallback); 198 public void onPurchaseCompleted(PurchaseResult result) {
189 199 Log.i(TAG,"purchase completed");
190 PurchaseCallback为支付状态回调接口,此接口含有3个方法 200 }
191 201
192 @Override 202 @Override
193 public void onPurchaseCompleted(PurchaseResult result) { 203 public void onPurchaseError(int code, String msg) {
194 Log.i(TAG,"purchase completed"); 204 Log.i(TAG,"purchase error");
195 } 205 }
196 206
197 @Override 207 @Override
198 public void onPurchaseError(int code, String msg) { 208 public void onPurchaseCanceled() {
199 Log.i(TAG,"purchase error"); 209 Log.i(TAG,"purchase canceled");
200 } 210 }
201 211
202 @Override 212 5.注销登录
203 public void onPurchaseCanceled() { 213
204 Log.i(TAG,"purchase canceled"); 214 GumpSDK.logout(Activity);
205 } 215 当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序!
206 216 ## 第二章 常见问题
207 5.注销登录 217 ### 问题1： 如何避免混淆对SDK的影响？
208 218 解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
209 GumpSDK.logout(Activity); 219 类，导致SDK无法正常工作，解决方法如下:
210 当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序! 220 Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
211 ## 第二章 常见问题 221
212 ### 问题1： 如何避免混淆对SDK的影响？ 222 -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable
213 解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java 223 -keep public class * extends android.app.Service
214 类，导致SDK无法正常工作，解决方法如下: 224 -keep public class com.google.vending.licensing.ILicensingService
1 # Gump IOS SDK使用文档 1 # Gump IOS SDK使用文档
2 2
3 3
4 接入手册 4 接入手册
5 V 5 V
6 2015年08月07日 6 2015年08月07日
7 7
8 8
9 9
10 ## 1、添加动态库 10 ## 1、添加动态库
11 在工程里添加MobileCoreServices.framework、SystemConfiguration.framework、libz.dylib、CFNetwork.framework、libletsgame.a、StoreKit.framework 11 在工程里添加MobileCoreServices.framework、SystemConfiguration.framework、libz.dylib、CFNetwork.framework、libletsgame.a、StoreKit.framework
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 49 [[LetsGameAPI instance] pay:payInfo];
50
51 ## 6、IAP支付
52 若要使用apple IAP支付，需要在AppDelegate的application: didFinishLaunchingWithOptions:方法内注册iap observer，使用如下方法
53
54 [[LetsGameAPI instance] registeIapObserver];
55 具体调用iap支付的方法如下：
56
57 [LetsGameAPI instance].appId = @"10022";
58 [LetsGameAPI instance].appKey = @"93a27b0bd99bac3e68a440b48aa421ab";
59 NSMutableDictionary *payInfo = [NSMutableDictionary dictionary];
60 [payInfo setValue:@"5001" forKey:@"serverId"];//当前用户所在的服务器Id
61 [payInfo setValue:@"10010" forKey:@"roleId"];//当前用户的角色id
62 [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id，用于统计
63 [payInfo setValue:@"10" forKey:@"amount"];//对应支付项的支付金额，实际支付金额以itunes配置为准
64 [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//扩展信息，可以游戏自定义，建议传自有订单号
65 [payInfo setValue:@"test.product.1" forKey:@"product"];//itunes 后台配置的对应支付项的productId
66 [[LetsGameAPI instance] iap:payInfo forUser:@"" handleCallback:^(NSString* orderId){
67 //此处的回调表明支付已经完成，但此时支付不一定成功，需要服务端验证支付结果
68 //orderId为gump生成的订单号，此订单号可以在gump server查询此笔支付是否成功
69 NSLog(@"iap completed orderId of gumptech:%@",orderId);
1 以下两个接口需要研发商提供,否则支付的时候会出现"获取支付信息失败"提示 1 以下两个接口需要研发商提供,否则支付的时候会出现"获取支付信息失败"提示
2 ---------------------------------- 2 ----------------------------------
3 接口请联系运营人员配置到Gump管理后台 3 接口请联系运营人员配置到Gump管理后台
4 4
5 5
6 第三方查询角色接口(需要研发商提供) 6 第三方查询角色接口(需要研发商提供)
7 ------------------------- 7 -------------------------
8 8
9 GumpTech调用过程如下： 9 GumpTech调用过程如下：
10 请求接口：queryRoleUrl的地址 10 请求接口：queryRoleUrl的地址
11 请求方式：post 11 请求方式：post
12 参数： 12 参数：
13 serverId servers参数json中的serverId的值 13 serverId servers参数json中的serverId的值
14 userId GumpTech用户id 14 userId GumpTech用户id
15 返回值： 15 返回值：
16 { 16 {
17 "userId":5104 17 "userId":5104
18 "roleId":5104 18 "roleId":5104
19 "roleName":"卡卡" 19 "roleName":"卡卡"
20 } 20 }
21 userId为GumpTech平台的用户id 21 userId为GumpTech平台的用户id
22 roleId为第三方平台的角色id 22 roleId为第三方平台的角色id
23 roleName为第三方平台的角色名字 23 roleName为第三方平台的角色名字
24 24
25 25
26 第三方查询区服列表接口(需要研发商提供) 26 第三方查询区服列表接口(需要研发商提供)
27 ------------------------- 27 -------------------------
28 28
29 29
30 Gump调用过程如下：querySeversUrl的地址 30 Gump调用过程如下：querySeversUrl的地址
31 31
32 请求方式：get方式 32 请求方式：get方式
33 参数：无 33 参数：无
34 返回值： 34 返回值：
35 35
36 字符串格式json串，如下： 36 字符串格式json串，如下：
37 [ 37 [
38 {"serverId":"s2", "serverName":"测试1"}, 38 {"serverId":"s2", "serverName":"测试1"},
39 {"serverId":"s2", "serverName":"测试1"} 39 {"serverId":"s2", "serverName":"测试1"}
40 ... 40 ...
41 ] 41 ]
42 42
43 43
44 充值成功通知第三方服务端接口 44 充值成功通知第三方服务端接口
45 ----------------------------- 45 -----------------------------
46 46
47 47
48 请参考[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 49
50 50
51 51
52 52
53 53
54 GumpTech页面支付(已集成到sdk中,可忽略) 54 GumpTech页面支付(已集成到sdk中,可忽略)
55 ----------------------- 55 -----------------------
56 56
57 接入使用方式： 57 接入使用方式：
58 ----------------------- 58 -----------------------
59 请使用浏览器方式嵌套GumpTech支付地址： 59 请使用浏览器方式嵌套GumpTech支付地址：
60 60
61 统一支付: http://api.gumptech.com/v2/p/index.do 61 统一支付: http://api.gumptech.com/v2/p/index.do
62 横版: http://api.gumptech.com/v2/wide/p/index.do 62 横版: http://api.gumptech.com/v2/wide/p/index.do
63 需要传入参数： 63 需要传入参数：
64 1. appId: 必选参数 接入前GumpTeck分配的应用id 64 1. appId: 必选参数 接入前GumpTeck分配的应用id
65 2. userId: 必选参数 GumpTech平台的用户id，如果传入，页面上角色名字字段会自动填写 65 2. userId: 必选参数 GumpTech平台的用户id，如果传入，页面上角色名字字段会自动填写
66 3. serverId: 必选参数 注意次参数为字符串，必须保证跟获取区服列表中serverId值保证一致 66 3. serverId: 必选参数 注意次参数为字符串，必须保证跟获取区服列表中serverId值保证一致
67 4. extraInfo: 必选参数 第三方自定义字段，字符200以内，原样回调给第三方。 67 4. extraInfo: 必选参数 第三方自定义字段，字符200以内，原样回调给第三方。
68 5. product: 必选参数 第三方传入，购买物品 68 5. product: 必选参数 第三方传入，购买物品
69 6. amount: 必选参数 第三方传入，购买物品所需要的金额(点数) 69 6. amount: 必选参数 第三方传入，购买物品所需要的金额(点数)
70 70
71 以下参数需要在服务端配置，需要研发商联系接口人配置： 71 以下参数需要在服务端配置，需要研发商联系接口人配置：
72 1. queryRoleUrl: 支付页面显示服务器列表 参考【第三方查询角色接口】 72 1. queryRoleUrl: 支付页面显示服务器列表 参考【第三方查询角色接口】
73 2. querySeversUrl: 查询用户角色 格式参考【第三方查询区服列表接口】 73 2. querySeversUrl: 查询用户角色 格式参考【第三方查询区服列表接口】
ios/ios_sdk_20150810.zip
Diff comments   View file @ 088dc87
No preview for this file type