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

doc/AndroidDocument.md
Diff comments   View file @ 088dc87
... ... @@ -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
... ... @@ -74,14 +76,11 @@ Help==>About Eclips点击Android对应的图标就可以查看版本了.
74 76  
75 77 <activity
76 78 android:name="com.gumptech.sdk.ContainerActivity"
77   - android:theme="@style/container_dialog"
78   - android:configChanges="orientation|screenLayout" >
  79 + android:configChanges="orientation|screenLayout"
  80 + android:windowSoftInputMode="stateAlwaysHidden|adjustPan"
  81 + android:theme="@style/Theme.TransparentWin" >
79 82 </activity>
80 83 <activity
81   - android:name="com.facebook.LoginActivity"
82   - android:theme="@android:style/Theme.Translucent.NoTitleBar" >
83   - </activity>
84   - <activity
85 84 android:name="com.gumptech.sdk.PaymentActivity"
86 85 android:configChanges="orientation|screenLayout"
87 86 android:theme="@android:style/Theme.Translucent.NoTitleBar" >
... ... @@ -89,28 +88,39 @@ Help==&gt;About Eclips点击Android对应的图标就可以查看版本了.
89 88 <activity
90 89 android:name="com.gumptech.sdk.ExchangeWindow"
91 90 android:configChanges="orientation|screenLayout"
92   - android:theme="@style/ex_win" >
  91 + android:theme="@style/Theme.WinForExchange" >
93 92 </activity>
  93 +
94 94 <service android:name="com.gumptech.sdk.PushService" >
95 95 </service>
  96 + <!-- facebook -->
96 97 <activity
97 98 android:name="com.facebook.FacebookActivity"
98 99 android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"
99 100 android:label="@string/app_name"
100 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 108  
102 109  
103 110 #### 2、 向Gump平台索要游戏ID（GID），完成代码接入
104 111 正式开始接入逻辑代码前,先介绍下一些附加配置,以方便代码接入
105   -*gump logo的显示控制方法,此方法参数指定是否显示GumpLogo
106   -
107   - GumpSDK.setShowLogo(boolean);
  112 +
108 113 *横竖屏控制,默认为横屏,参数为false即为竖屏
109 114  
110 115 GumpSDK.setScreenLandscape(true);
111 116 *debug模式设置
112 117  
113 118 GumpSDK.setDebugState(true);
  119 +
  120 +*设置是否启用Facebook登录和VK登录
  121 +
  122 + GumpSDK.setFBEnable(true);
  123 + GumpSDK.setVKEnable(true);
114 124 1.调用GumpSDK前需要执行初始化。
115 125  
116 126 若不需要分渠道
... ... @@ -160,7 +170,7 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
160 170  
161 171  
162 172 3.支付功能
163   - 1)使用gump通行证登录,其中serverId为必传参数
  173 + 1)使用gump通行证登录,其中除nick外所有参数为必传参数
164 174  
165 175 Bundle payInfo = new Bundle();
166 176 payInfo.putString("nick", "thi");
... ... @@ -170,8 +180,8 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
170 180 payInfo.putString("serverId", "B4003");
171 181 payInfo.putString("roleId", "10010");
172 182 GumpSDK.pay(MainActivity.this, payInfo,PurchaseCallback);
173   -调用pay方法时,必须穿入一个bundle对象,包含如上字段,除serverId外可以设置值为空,但是字段必须全部包含
174   - 2)未使用gump通行证登录,需要传入用户id,serverId为必传参数
  183 +调用pay方法时,必须穿入一个bundle对象,包含如上字段,除nick外所有字段必须全部包含
  184 + 2)未使用gump通行证登录,需要传入用户id
175 185  
176 186 Bundle payInfo = new Bundle();
177 187 payInfo.putString("nick", "thi");
... ... @@ -180,7 +190,7 @@ InitializeCallback为初始化回调接口,此接口只有一个回调方法init
180 190 payInfo.putString("extraInfo", "This is demo!");
181 191 payInfo.putString("serverId", "B4003");
182 192 payInfo.putString("roleId", "10010");
183   - GumpSDK.pay(MainActivity.this, payInfo,"1021",PurchaseCallback);
  193 + GumpSDK.pay(MainActivity.this, payInfo,userId,PurchaseCallback);
184 194  
185 195 PurchaseCallback为支付状态回调接口,此接口含有3个方法
186 196  
... ... @@ -217,4 +227,4 @@ PurchaseCallback为支付状态回调接口,此接口含有3个方法
217 227 -keep class com.gumptech.sdk.web.* {*;}
218 228  
219 229  
220   -使得混淆的时候不会影响SDK的命名空间。
  230 +使得混淆的时候不会影响SDK的命名空间。
221 231 \ 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 @ 088dc87
No preview for this file type