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 Side-by-side Diff

doc/AndroidDocument.md
Diff comments   View file @ b609b4d
... ... @@ -2,8 +2,8 @@
2 2  
3 3  
4 4 接入手册
5   -V 3.2.0
6   -2015年07月29日
  5 +V 3.3.0
  6 +2015年08月30日
7 7  
8 8 快速入口:
9 9 [支付部分服务端回调文档](http://git.letsgame.mobi/document/gumptech-document/blob/master/doc/ServerDocument.md)
... ... @@ -28,7 +28,9 @@ V 3.2.0
28 28  
29 29 本接口API 适用于Android2.2以上各版本Android平台。
30 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 35 ![](images/1.png)
34 36 图1
... ... @@ -102,15 +104,18 @@ Help==>About Eclips点击Android对应的图标就可以查看版本了.
102 104  
103 105 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入
104 106 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入
105   -*gump logo的显示控制方法,此方法参数指定是否显示GumpLogo
106   -
107   - GumpSDK.setShowLogo(boolean);
  107 +
108 108 *横竖屏控制,默认为横屏,参数为false即为竖屏
109 109  
110 110 GumpSDK.setScreenLandscape(true);
111 111 *debug模式设置
112 112  
113 113 GumpSDK.setDebugState(true);
  114 +
  115 +*设置是否启用Facebook登录和VK登录
  116 +
  117 + GumpSDK.setFBEnable(true);
  118 + GumpSDK.setVKEnable(true);
114 119 1.调用GumpSDK前需要执行初始化。
115 120  
116 121 若不需要分渠道
... ... @@ -160,7 +165,7 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
160 165  
161 166  
162 167 3.支付功能
163   - 1)使用gump通行证登录,其中serverId为必传参数
  168 + 1)使用gump通行证登录,其中除nick外所有参数为必传参数
164 169  
165 170 Bundle payInfo = new Bundle();
166 171 payInfo.putString("nick", "thi");
... ... @@ -170,8 +175,8 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
170 175 payInfo.putString("serverId", "B4003");
171 176 payInfo.putString("roleId", "10010");
172 177 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback);
173   -调用pay方法时,必须穿入一个bundle对象,包含如上字段,除serverId外可以设置值为空,但是字段必须全部包含
174   - 2)未使用gump通行证登录,需要传入用户id,serverId为必传参数
  178 +调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含
  179 + 2)未使用gump通行证登录,需要传入用户id
175 180  
176 181 Bundle payInfo = new Bundle();
177 182 payInfo.putString("nick", "thi");
... ... @@ -180,7 +185,7 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
180 185 payInfo.putString("extraInfo", "This is demo!");
181 186 payInfo.putString("serverId", "B4003");
182 187 payInfo.putString("roleId", "10010");
183   - GumpSDK.pay(MainActivity.this, payInfo,"1021",PurchaseCallback);
  188 + GumpSDK.pay(MainActivity.this, payInfo,userId,PurchaseCallback);
184 189  
185 190 PurchaseCallback为支付状态回调接口,此接口含有3个方法
186 191  
... ... @@ -217,4 +222,4 @@ PurchaseCallback为支付状态回调接口,此接口含有3个方法
217 222 -keep class com.gumptech.sdk.web.* {*;}
218 223  
219 224  
220   -使得混淆的时候不会影响SDK的命名空间。
  225 +使得混淆的时候不会影响SDK的命名空间。
221 226 \ No newline at end of file
... ... @@ -3,12 +3,12 @@
3 3  
4 4 接入手册
5 5 V
6   -2015年02月13日
  6 +2015年08月07日
7 7  
8 8  
9 9  
10 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 14 ## 2、设置头文件搜索路径
... ... @@ -37,7 +37,7 @@ V
37 37 };
38 38  
39 39  
40   -## 5、支付
  40 +## 5、第三方支付
41 41 [LetsGameAPI instance].appId = @"10022";
42 42 [LetsGameAPI instance].appKey = @"f899139df5e1059396431415e770c6dd";
43 43 NSMutableDictionary *payInfo = [NSMutableDictionary dictionary];
... ... @@ -46,4 +46,25 @@ V
46 46 [payInfo setValue:@"10" forKey:@"amount"];//金额
47 47 [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//外部订单信息
48 48 [payInfo setValue:@"元宝" forKey:@"product"];//物品信息
49   - [[LetsGameAPI instance] pay:payInfo];
50 49 \ No newline at end of file
  50 + [[LetsGameAPI instance] pay:payInfo];
  51 +
  52 +## 6、IAP支付
  53 +若要使用apple IAP支付，需要在AppDelegate的application: didFinishLaunchingWithOptions:方法内注册iap observer，使用如下方法
  54 +
  55 + [[LetsGameAPI instance] registeIapObserver];
  56 +具体调用iap支付的方法如下：
  57 +
  58 + [LetsGameAPI instance].appId = @"10022";
  59 + [LetsGameAPI instance].appKey = @"93a27b0bd99bac3e68a440b48aa421ab";
  60 + NSMutableDictionary *payInfo = [NSMutableDictionary dictionary];
  61 + [payInfo setValue:@"5001" forKey:@"serverId"];//当前用户所在的服务器Id
  62 + [payInfo setValue:@"10010" forKey:@"roleId"];//当前用户的角色id
  63 + [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id，用于统计
  64 + [payInfo setValue:@"10" forKey:@"amount"];//对应支付项的支付金额，实际支付金额以itunes配置为准
  65 + [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//扩展信息，可以游戏自定义，建议传自有订单号
  66 + [payInfo setValue:@"test.product.1" forKey:@"product"];//itunes 后台配置的对应支付项的productId
  67 + [[LetsGameAPI instance] iap:payInfo forUser:@"" handleCallback:^(NSString* orderId){
  68 + //此处的回调表明支付已经完成，但此时支付不一定成功，需要服务端验证支付结果
  69 + //orderId为gump生成的订单号，此订单号可以在gump server查询此笔支付是否成功
  70 + NSLog(@"iap completed orderId of gumptech:%@",orderId);
  71 + }];
51 72 \ No newline at end of file
... ... @@ -64,9 +64,9 @@ GumpTech页面支付(已集成到sdk中,可忽略)
64 64 1. appId: 必选参数 接入前GumpTeck分配的应用id
65 65 2. userId: 必选参数 GumpTech平台的用户id，如果传入，页面上角色名字字段会自动填写
66 66 3. serverId: 必选参数 注意次参数为字符串，必须保证跟获取区服列表中serverId值保证一致
67   - 4. extraInfo: 可选参数 第三方自定义字段，字符200以内，原样回调给第三方。
68   - 5. product: 可选参数 第三方传入，购买物品
69   - 6. amount: 可选参数 第三方传入，购买物品所需要的金额(点数)
  67 + 4. extraInfo: 必选参数 第三方自定义字段，字符200以内，原样回调给第三方。
  68 + 5. product: 必选参数 第三方传入，购买物品
  69 + 6. amount: 必选参数 第三方传入，购买物品所需要的金额(点数)
70 70  
71 71 以下参数需要在服务端配置，需要研发商联系接口人配置：
72 72 1. queryRoleUrl: 支付页面显示服务器列表 参考【第三方查询角色接口】
ios/ios_sdk_20150810.zip
Diff comments   View file @ b609b4d
No preview for this file type