调用API
1.Appdelegate中调用以下方法
引用头文件：
#import <JHToolsSDKCore/JHToolsSDKCore.h>
初始化SDK
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];
[self.window makeKeyAndVisible];
//初始化应该在程序启动时调用, 也就是在didFinishLaunchingWithOptions方法里
NSDictionary *sdkconfig = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"JHToolsSDK"];
[[JHToolsSDK sharedInstance] initWithParams:sdkconfig];
[[JHToolsSDK sharedInstance] application:application didFinishLaunchingWithOptions:launchOptions];
[[JHToolsAnalytics sharedInstance] startLevel:@"1"];
self.window.rootViewController = [[ViewController alloc] init];
return YES;
}
AppDelegate事件处理:
需要在AppDelegate以下对应的生命周期方法中调用JHToolsSDK种对应这些方法：
-(void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
[[JHToolsSDK sharedInstance] application:application didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(nonnull NSDictionary *)userInfo
{
[[JHToolsSDK sharedInstance] application:application didReceiveRemoteNotification:userInfo];
}
-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler
{
[[JHToolsSDK sharedInstance] application:application didReceiveRemoteNotification:userInfo];
}
-(void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
{
[[JHToolsSDK sharedInstance] application:application didReceiveLocalNotification:notification];
}
- (void)applicationWillResignActive:(UIApplication *)application {
[[JHToolsSDK sharedInstance] applicationWillResignActive:application];
}
- (void)applicationDidEnterBackground:(UIApplication *)application {
[[JHToolsSDK sharedInstance] applicationDidEnterBackground:application];
}
- (void)applicationWillEnterForeground:(UIApplication *)application {
[[JHToolsSDK sharedInstance] applicationWillEnterForeground:application];
}
- (void)applicationDidBecomeActive:(UIApplication *)application {
[[JHToolsSDK sharedInstance] applicationDidBecomeActive:application];
}
- (void)applicationWillTerminate:(UIApplication *)application {
[[JHToolsSDK sharedInstance] applicationWillTerminate:application];
}
-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
return [[JHToolsSDK sharedInstance] application:application handleOpenURL:url];
}
-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
return [[JHToolsSDK sharedInstance] application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
}
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options{
return [[JHToolsSDK sharedInstance] application:application openURL:url options:options];
}
-(UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window{
return [[JHToolsSDK sharedInstance] application:application supportedInterfaceOrientationsForWindow:window];
}
2.游戏主界面viewController
实现JHToolsSDKDelegate协议，并且实现协议中定义的方法，在ViewController中的viewDidLoad方法中调用：
[[JHToolsSDK sharedInstance] setDelegate:self];
实现协议方法：
这些协议回调根据渠道可能会有，也可能不回掉
#pragma mark --<JHToolsSDKDelegate>
-(UIView*) GetView{
return [self GetViewController].view;;
}
-(UIViewController*) GetViewController{
return self;
}
//SDK初始化成功回调
-(void) OnPlatformInit:(NSDictionary*)params{
}
//登录成功回调
-(void) OnUserLogin:(NSDictionary*)params{
}
//登出回调
-(void) OnUserLogout:(NSDictionary*)params{
}
//支付回调
-(void) OnPayPaid:(NSDictionary*)params{
}
//事件回调
-(void) OnEventCustom:(NSString*)eventName params:(NSDictionary*)params{
}
3.用户功能API调用
1) 登录(必须实现)
调用登录接口，打开SDK登录界面
[[JHToolsSDK sharedInstance] login];
2) 切换账号(必须实现)
部分渠道没有支持切换账号接口，那么切换账号默认调用的接口和登录相同。
[[JHToolsSDK sharedInstance] switchAccount];
3) 登出(非必需实现)
部分渠道没有登出接口，那么登出接口默认不做任何实现
[[JHToolsSDK sharedInstance] logout];
4) 显示个人中心
Note: 部分渠道要求游戏内必须要有［个人中心］按钮，点击进入渠道SDK的个人中心界面.但是因为是部分渠道有这个接口，部分渠道没有提供这个接口，所以，对于没有提供该接口的渠道，该方法不做任何逻辑。
游戏层需要根据支付支持该方法的判定，来显示或者隐藏该按钮。
调用该方法时，先判断当前渠道是否提供了个人中心接口：
if([[JHToolsSDK sharedInstance].defaultUser hasAccountCenter])
{
[[JHToolsSDK sharedInstance] showAccountCenter];
}
5）支付接口
在调用支付的时候，游戏中需要传入对应的参数，然后调用支付插件的pay方法：
JHToolsProductInfo* productInfo = [[JHToolsProductInfo alloc] init];
productInfo.orderID = @"1782341234";
productInfo.productName = @"礼包1";
productInfo.productDesc = @"礼包1";
productInfo.productId = @"com.669.jianqilingyun.600";
productInfo.price = [NSNumber numberWithInt:1];
productInfo.buyNum = 1;
productInfo.coinNum = 900;
productInfo.roleId = @"12345";
productInfo.roleName = @"角色";
productInfo.roleLevel = @"66";
productInfo.serverId = @"1";
productInfo.serverName = @"桃源";
productInfo.vip = @"1";
productInfo.extension = @"hjghjklhjk";
productInfo.notifyUrl = @"http://110.54.33.45/game/pay/notify";
[[JHToolsSDK sharedInstance] pay:productInfo];
//参数dic是一个JHToolsProductInfo对象 支付成功的回调，可以在上面OnPayPaid回调方法中进行处理。一般网游这里不需要做特殊的处理，因为支付是异步的，这里支付成功，仅仅是SDK支付请求成功，并不代表玩家得到了游戏币。真正充值成功，是异步通知到游戏服务器的。
关于支付参数的说明：
6）提交用户数据，用户登录、进入游戏、升级、退出游戏时候调用
JHToolsUserExtraData* extraData = [[JHToolsUserExtraData alloc] init];
extraData.dataType = TYPE_ENTER_GAME;
extraData.roleID = @"testRole";
extraData.roleName = @"角色名称";
extraData.serverID = 1;
extraData.serverName = @"第一区";
extraData.roleLevel = @"1";
extraData.moneyNum = 100;
extraData.roleCreateTime = time(NULL);
extraData.roleLevelUpTime = time(NULL);
[[JHToolsSDK sharedInstance] submitExtraData:extraData];
NOTE:选择服务器时，因为还没有进入游戏，无法知道角色数据，extraData中只需要传入服务器信息即可。
