SDK / GameSDK-Doc

Download as
Browse Code »

Commit b609b4dd7e8719e0880359f8b61cda04ac969d68

Authored by 赵康
2 parents 4c1c42af51 55bb6b290b
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 @ b609b4d
1 # Gump Android SDK使用文档 1 # Gump Android SDK使用文档
2 2
3 3
4 接入手册 4 接入手册
5 V 3.2.0 5 V 3.3.0
6 2015年07月29日 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.将LoginSDK资源工程拷贝到工作空间，在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 34
33 ![](images/1.png) 35 ![](images/1.png)
34 图1 36 图1
35 37
36 2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。 38 2.导入工程后，右键此工程，在Properties->Android中选中此工程为library工程（勾选红色方框标识处）如图2。
37 ![](images/2.png) 39 ![](images/2.png)
38 图 2 40 图 2
39 ### 2. 添加资源工程 41 ### 2. 添加资源工程
40 添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。 42 添加资源工程为游戏项目的 library。右键游戏项目，在Properties->Android中点击Add添加资源工程为项目工程的library，结果如图3。
41 ![](images/3.png) 43 ![](images/3.png)
42 图 3 44 图 3
43 45
44 46
45 注意:如果ADT版本低于14，ADT不支持jar包自动引入，请手动拷贝libs到您的工作 47 注意:如果ADT版本低于14，ADT不支持jar包自动引入，请手动拷贝libs到您的工作
46 空间。 48 空间。
47 49
48 Eclipse查看ADT版本号的方法: 50 Eclipse查看ADT版本号的方法:
49 Help==>About Eclips点击Android对应的图标就可以查看版本了. 51 Help==>About Eclips点击Android对应的图标就可以查看版本了.
50 如图，红色框部分就是ADT版本号。 52 如图，红色框部分就是ADT版本号。
51 53
52 ![](images/4.png) 54 ![](images/4.png)
53 55
54 56
55 ### 3. 代码实现 57 ### 3. 代码实现
56 #### 1、 修改AndroidManifest.xml文件 58 #### 1、 修改AndroidManifest.xml文件
57 首先添加必要的权限，如下所示： 59 首先添加必要的权限，如下所示：
58 60
59 <uses-permission android:name="android.permission.INTERNET" /> 61 <uses-permission android:name="android.permission.INTERNET" />
60 <uses-permission android:name="android.permission.READ_PHONE_STATE" /> 62 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
61 <uses-permission android:name="android.permission.BLUETOOTH" /> 63 <uses-permission android:name="android.permission.BLUETOOTH" />
62 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 64 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
63 <uses-permission android:name="android.permission.WRITE_SETTINGS"/> 65 <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
64 <uses-permission android:name="android.permission.GET_ACCOUNTS"/> 66 <uses-permission android:name="android.permission.GET_ACCOUNTS"/>
65 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 67 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
66 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 68 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
67 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 69 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
68 <uses-permission android:name="android.permission.SEND_SMS"/> 70 <uses-permission android:name="android.permission.SEND_SMS"/>
69 71
70 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. --> 72 <!-- VERY IMPORTANT! Don't forget this permission, or in-app billing won't work. -->
71 <uses-permission android:name="com.android.vending.BILLING" /> 73 <uses-permission android:name="com.android.vending.BILLING" />
72 74
73 其次注册相应的Activity，具体如下： 75 其次注册相应的Activity，具体如下：
74 76
75 <activity 77 <activity
76 android:name="com.gumptech.sdk.ContainerActivity" 78 android:name="com.gumptech.sdk.ContainerActivity"
77 android:theme="@style/container_dialog" 79 android:theme="@style/container_dialog"
78 android:configChanges="orientation|screenLayout" > 80 android:configChanges="orientation|screenLayout" >
79 </activity> 81 </activity>
80 <activity 82 <activity
81 android:name="com.facebook.LoginActivity" 83 android:name="com.facebook.LoginActivity"
82 android:theme="@android:style/Theme.Translucent.NoTitleBar" > 84 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
83 </activity> 85 </activity>
84 <activity 86 <activity
85 android:name="com.gumptech.sdk.PaymentActivity" 87 android:name="com.gumptech.sdk.PaymentActivity"
86 android:configChanges="orientation|screenLayout" 88 android:configChanges="orientation|screenLayout"
87 android:theme="@android:style/Theme.Translucent.NoTitleBar" > 89 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
88 </activity> 90 </activity>
89 <activity 91 <activity
90 android:name="com.gumptech.sdk.ExchangeWindow" 92 android:name="com.gumptech.sdk.ExchangeWindow"
91 android:configChanges="orientation|screenLayout" 93 android:configChanges="orientation|screenLayout"
92 android:theme="@style/ex_win" > 94 android:theme="@style/ex_win" >
93 </activity> 95 </activity>
94 <service android:name="com.gumptech.sdk.PushService" > 96 <service android:name="com.gumptech.sdk.PushService" >
95 </service> 97 </service>
96 <activity 98 <activity
97 android:name="com.facebook.FacebookActivity" 99 android:name="com.facebook.FacebookActivity"
98 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" 100 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
99 android:label="@string/app_name" 101 android:label="@string/app_name"
100 android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 102 android:theme="@android:style/Theme.Translucent.NoTitleBar" />
101 103
102 104
103 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入 105 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入
104 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入 106 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入
105 *gump logo的显示控制方法,此方法参数指定是否显示GumpLogo 107
106
107 GumpSDK.setShowLogo(boolean);
108 *横竖屏控制,默认为横屏,参数为false即为竖屏 108 *横竖屏控制,默认为横屏,参数为false即为竖屏
109 109
110 GumpSDK.setScreenLandscape(true); 110 GumpSDK.setScreenLandscape(true);
111 *debug模式设置 111 *debug模式设置
112 112
113 GumpSDK.setDebugState(true); 113 GumpSDK.setDebugState(true);
114
115 *设置是否启用Facebook登录和VK登录
116
117 GumpSDK.setFBEnable(true);
118 GumpSDK.setVKEnable(true);
114 1.调用GumpSDK前需要执行初始化。 119 1.调用GumpSDK前需要执行初始化。
115 120
116 若不需要分渠道 121 若不需要分渠道
117 122
118 GumpSDK.init(Context,Appid, Appkey,InitializeCallback); 123 GumpSDK.init(Context,Appid, Appkey,InitializeCallback);
119 如果需要定义渠道,必须使用如下方法 124 如果需要定义渠道,必须使用如下方法
120 125
121 GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback); 126 GumpSDK.init(Context,Appid, Appkey,ChannelId,InitializeCallback);
122 127
123 InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败 128 InitializeCallback为初始化回调接口,此接口只有一个回调方法initComplete(int result) result标识是否初始化成功,当result等于GumpSDK.CODE.OK时为成功,其他为失败
124 129
125 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数 130 2.调用GumpSDK的开始方法,将执行登录流程,需要一个Activity实例作参数
126 131
127 GumpSDK.start(Activity); 132 GumpSDK.start(Activity);
128 在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下: 133 在此之前,开发者需要注册用户状态监听以接受用户的登录/登出通知,通常如下:
129 134
130 GumpSDK.setUserStateListener(new LoginStateListener() { 135 GumpSDK.setUserStateListener(new LoginStateListener() {
131 @Override 136 @Override
132 public void onLoginSuccess(GumpUser gumpUser) { 137 public void onLoginSuccess(GumpUser gumpUser) {
133 //登录成功,用户信息包含在GumpUser对象里 138 //登录成功,用户信息包含在GumpUser对象里
134 } 139 }
135 140
136 @Override 141 @Override
137 public void onLoginFailed(int code, String msg) { 142 public void onLoginFailed(int code, String msg) {
138 //登录出错,根据错误码和信息判断错误类型 143 //登录出错,根据错误码和信息判断错误类型
139 Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show(); 144 Toast.makeText(MainActivity.this, "Login failed:code="+code+",message="+msg, Toast.LENGTH_SHORT).show();
140 } 145 }
141 146
142 @Override 147 @Override
143 public void onLoginCanceled() { 148 public void onLoginCanceled() {
144 //用户取消登录 149 //用户取消登录
145 Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show(); 150 Toast.makeText(MainActivity.this, "operate be canceled", Toast.LENGTH_SHORT).show();
146 } 151 }
147 152
148 @Override 153 @Override
149 public void onLogout() { 154 public void onLogout() {
150 //用户登出 155 //用户登出
151 156
152 } 157 }
153 }); 158 });
154 159
155 如上成功登录后收到的GumpUser对象包含以下信息 160 如上成功登录后收到的GumpUser对象包含以下信息
156 161
157 gumpUser.getUid();//获取用户的userid,此Id标识唯一用户! 162 gumpUser.getUid();//获取用户的userid,此Id标识唯一用户!
158 gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取 163 gumpUser.getAccountType();//用户类型,此类型数据可从GumpPreference常量获取
159 gumpUser.getSessionKey();//登录的sesionKey 164 gumpUser.getSessionKey();//登录的sesionKey
160 165
161 166
162 3.支付功能 167 3.支付功能
163 1)使用gump通行证登录,其中serverId为必传参数 168 1)使用gump通行证登录,其中除nick外所有参数为必传参数
164 169
165 Bundle payInfo = new Bundle(); 170 Bundle payInfo = new Bundle();
166 payInfo.putString("nick", "thi"); 171 payInfo.putString("nick", "thi");
167 payInfo.putString("product", "元宝"); 172 payInfo.putString("product", "元宝");
168 payInfo.putFloat("amount", 40.0f); 173 payInfo.putFloat("amount", 40.0f);
169 payInfo.putString("extraInfo", "This is demo!"); 174 payInfo.putString("extraInfo", "This is demo!");
170 payInfo.putString("serverId", "B4003"); 175 payInfo.putString("serverId", "B4003");
171 payInfo.putString("roleId", "10010"); 176 payInfo.putString("roleId", "10010");
172 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback); 177 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback);
173 调用pay方法时,必须穿入一个bundle对象,包含如上字段,除serverId外可以设置值为空,但是字段必须全部包含 178 调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含
174 2)未使用gump通行证登录,需要传入用户id,serverId为必传参数 179 2)未使用gump通行证登录,需要传入用户id
175 180
176 Bundle payInfo = new Bundle(); 181 Bundle payInfo = new Bundle();
177 payInfo.putString("nick", "thi"); 182 payInfo.putString("nick", "thi");
178 payInfo.putString("product", "元宝"); 183 payInfo.putString("product", "元宝");
179 payInfo.putFloat("amount", 40.0f); 184 payInfo.putFloat("amount", 40.0f);
180 payInfo.putString("extraInfo", "This is demo!"); 185 payInfo.putString("extraInfo", "This is demo!");
181 payInfo.putString("serverId", "B4003"); 186 payInfo.putString("serverId", "B4003");
182 payInfo.putString("roleId", "10010"); 187 payInfo.putString("roleId", "10010");
183 GumpSDK.pay(MainActivity.this, payInfo,"1021",PurchaseCallback); 188 GumpSDK.pay(MainActivity.this, payInfo,userId,PurchaseCallback);
184 189
185 PurchaseCallback为支付状态回调接口,此接口含有3个方法 190 PurchaseCallback为支付状态回调接口,此接口含有3个方法
186 191
187 @Override 192 @Override
188 public void onPurchaseCompleted(PurchaseResult result) { 193 public void onPurchaseCompleted(PurchaseResult result) {
189 Log.i(TAG,"purchase completed"); 194 Log.i(TAG,"purchase completed");
190 } 195 }
191 196
192 @Override 197 @Override
193 public void onPurchaseError(int code, String msg) { 198 public void onPurchaseError(int code, String msg) {
194 Log.i(TAG,"purchase error"); 199 Log.i(TAG,"purchase error");
195 } 200 }
196 201
197 @Override 202 @Override
198 public void onPurchaseCanceled() { 203 public void onPurchaseCanceled() {
199 Log.i(TAG,"purchase canceled"); 204 Log.i(TAG,"purchase canceled");
200 } 205 }
201 206
202 5.注销登录 207 5.注销登录
203 208
204 GumpSDK.logout(Activity); 209 GumpSDK.logout(Activity);
205 当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序! 210 当此方法调用后,用户退出登录,并会通过LoginStateListener接口通知调用程序!
206 ## 第二章 常见问题 211 ## 第二章 常见问题
207 ### 问题1： 如何避免混淆对SDK的影响？ 212 ### 问题1： 如何避免混淆对SDK的影响？
208 解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java 213 解答：有些开发者对接入了SDK的程序进行混淆时，有可能会覆盖某些java
209 类，导致SDK无法正常工作，解决方法如下: 214 类，导致SDK无法正常工作，解决方法如下:
210 Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上 215 Ø 请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上
211 216
212 -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable 217 -keepattributes *Annotation*,InnerClasses,SourceFile,LineNumberTable
213 -keep public class * extends android.app.Service 218 -keep public class * extends android.app.Service
214 -keep public class com.google.vending.licensing.ILicensingService 219 -keep public class com.google.vending.licensing.ILicensingService
215 -keep public class com.android.vending.licensing.ILicensingService 220 -keep public class com.android.vending.licensing.ILicensingService
216 -keep class com.gumptech.sdk.view.* {*;} 221 -keep class com.gumptech.sdk.view.* {*;}
217 -keep class com.gumptech.sdk.web.* {*;} 222 -keep class com.gumptech.sdk.web.* {*;}
218 223
1 # Gump IOS SDK使用文档 1 # Gump IOS SDK使用文档
2 2
3 3
4 接入手册 4 接入手册
5 V 5 V
6 2015年02月13日 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 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];
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 @ b609b4d
No preview for this file type