Commit ca2f3a93591eed97f4c309cfde79de39052ffef8
1 parent
088dc87920
Exists in
master
增加vk配置项说明
Showing 1 changed file with 14 additions and 6 deletions Inline Diff
doc/IOSDocument.md
1 | # Gump IOS SDK使用文档 | 1 | # Gump IOS SDK使用文档 |
2 | 2 | ||
3 | 3 | ||
4 | 接入手册 | 4 | 接入手册 |
5 | V | 5 | V |
6 | 2015年08月07日 | 6 | 2015年09月25日 |
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、VKSdk.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和VKSDKResources.bundle资源文件,里面包含图片及相关语言包 |
20 | 20 | ||
21 | ## 4、为vk增加必要配置 | ||
22 | 1)在application delegate方法中, 在application:openURL:sourceApplication:annotation:添加返回: | ||
21 | 23 | ||
22 | ## 4、在工程里添加SDK登录代码 | 24 | return [[LetsGameAPI instance] handleOpenURL:url sourceApplication:sourceApplication]; |
25 | |||
26 | 2)配置URL-schema | ||
27 | Xcode 5: Open your application settings then select the Info tab. In the URL Types section click the plus sign. Enter vk+APP_ID (e.g. vk1234567) to the Identifier and URL Schemes fields. | ||
28 | Xcode 4: Open your Info.plist then add a new row URL Types. Set the URL identifier to vk+APP_ID | ||
29 | ## 5、在工程里添加SDK登录代码 | ||
23 | 30 | ||
24 | [LetsGameAPI instance].appId = @"100"; // 设置appId | 31 | [LetsGameAPI instance].appId = @"100"; // 设置appId |
25 | [LetsGameAPI instance].appKey = @"100"; // 设置appKey | 32 | [LetsGameAPI instance].appKey = @"100"; // 设置appKey |
33 | [LetsGameAPI instance].vkAppId = @"5029792"; //设置vkAppId | ||
26 | 34 | ||
27 | [[LetsGameAPI instance] showLoginView]; // 弹出登录页面 | 35 | [[LetsGameAPI instance] showLoginView]; // 弹出登录页面 |
28 | 36 | ||
29 | // 登录成功回调 | 37 | // 登录成功回调 |
30 | [LetsGameAPI instance].succBlock = ^(NSString *userId, NSString *sessionKey, LSGAccountType type) { | 38 | [LetsGameAPI instance].succBlock = ^(NSString *userId, NSString *sessionKey, LSGAccountType type) { |
31 | NSLog(@"%@", [NSString stringWithFormat:@"login succ: userId = %@, sessionKey = %@, accountType = %d", userId, sessionKey, type]); | 39 | NSLog(@"%@", [NSString stringWithFormat:@"login succ: userId = %@, sessionKey = %@, accountType = %d", userId, sessionKey, type]); |
32 | }; | 40 | }; |
33 | 41 | ||
34 | // 登录失败回调 | 42 | // 登录失败回调 |
35 | [LetsGameAPI instance].dismissBlock = ^() { | 43 | [LetsGameAPI instance].dismissBlock = ^() { |
36 | NSLog(@"dismiss without login"); | 44 | NSLog(@"dismiss without login"); |
37 | }; | 45 | }; |
38 | 46 | ||
39 | 47 | ||
40 | ## 5、第三方支付 | 48 | ## 6、第三方支付 |
41 | [LetsGameAPI instance].appId = @"10022"; | 49 | [LetsGameAPI instance].appId = @"10022"; |
42 | [LetsGameAPI instance].appKey = @"f899139df5e1059396431415e770c6dd"; | 50 | [LetsGameAPI instance].appKey = @"f899139df5e1059396431415e770c6dd"; |
43 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; | 51 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; |
44 | [payInfo setValue:@"5001" forKey:@"serverId"];//服务器id,必传参数 | 52 | [payInfo setValue:@"5001" forKey:@"serverId"];//服务器id,必传参数 |
45 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id | 53 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id |
46 | [payInfo setValue:@"10" forKey:@"amount"];//金额 | 54 | [payInfo setValue:@"10" forKey:@"amount"];//金额 |
47 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//外部订单信息 | 55 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//外部订单信息 |
48 | [payInfo setValue:@"元宝" forKey:@"product"];//物品信息 | 56 | [payInfo setValue:@"元宝" forKey:@"product"];//物品信息 |
49 | [[LetsGameAPI instance] pay:payInfo]; | 57 | [[LetsGameAPI instance] pay:payInfo]; |
50 | 58 | ||
51 | ## 6、IAP支付 | 59 | ## 7、IAP支付 |
52 | 若要使用apple IAP支付,需要在AppDelegate的application: didFinishLaunchingWithOptions:方法内注册iap observer,使用如下方法 | 60 | 若要使用apple IAP支付,需要在AppDelegate的application: didFinishLaunchingWithOptions:方法内注册iap observer,使用如下方法 |
53 | 61 | ||
54 | [[LetsGameAPI instance] registeIapObserver]; | 62 | [[LetsGameAPI instance] registeIapObserver]; |
55 | 具体调用iap支付的方法如下: | 63 | 具体调用iap支付的方法如下: |
56 | 64 | ||
57 | [LetsGameAPI instance].appId = @"10022"; | 65 | [LetsGameAPI instance].appId = @"10022"; |
58 | [LetsGameAPI instance].appKey = @"93a27b0bd99bac3e68a440b48aa421ab"; | 66 | [LetsGameAPI instance].appKey = @"93a27b0bd99bac3e68a440b48aa421ab"; |
59 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; | 67 | NSMutableDictionary *payInfo = [NSMutableDictionary dictionary]; |
60 | [payInfo setValue:@"5001" forKey:@"serverId"];//当前用户所在的服务器Id | 68 | [payInfo setValue:@"5001" forKey:@"serverId"];//当前用户所在的服务器Id |
61 | [payInfo setValue:@"10010" forKey:@"roleId"];//当前用户的角色id | 69 | [payInfo setValue:@"10010" forKey:@"roleId"];//当前用户的角色id |
62 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id,用于统计 | 70 | [payInfo setValue:@"1000" forKey:@"channelId"];//渠道id,用于统计 |
63 | [payInfo setValue:@"10" forKey:@"amount"];//对应支付项的支付金额,实际支付金额以itunes配置为准 | 71 | [payInfo setValue:@"10" forKey:@"amount"];//对应支付项的支付金额,实际支付金额以itunes配置为准 |
64 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//扩展信息,可以游戏自定义,建议传自有订单号 | 72 | [payInfo setValue:@"ios demo" forKey:@"extraInfo"];//扩展信息,可以游戏自定义,建议传自有订单号 |
65 | [payInfo setValue:@"test.product.1" forKey:@"product"];//itunes 后台配置的对应支付项的productId | 73 | [payInfo setValue:@"test.product.1" forKey:@"product"];//itunes 后台配置的对应支付项的productId |
66 | [[LetsGameAPI instance] iap:payInfo forUser:@"" handleCallback:^(NSString* orderId){ | 74 | [[LetsGameAPI instance] iap:payInfo forUser:@"" handleCallback:^(NSString* orderId){ |
67 | //此处的回调表明支付已经完成,但此时支付不一定成功,需要服务端验证支付结果 | 75 | //此处的回调表明支付已经完成,但此时支付不一定成功,需要服务端验证支付结果 |
68 | //orderId为gump生成的订单号,此订单号可以在gump server查询此笔支付是否成功 | 76 | //orderId为gump生成的订单号,此订单号可以在gump server查询此笔支付是否成功 |
69 | NSLog(@"iap completed orderId of gumptech:%@",orderId); | 77 | NSLog(@"iap completed orderId of gumptech:%@",orderId); |
70 | }]; | 78 | }]; |