ZBGameSDK集成和使用

一、准备所需文件

WechatIMG1.jpeg

因为ZBGameSDK涉及到Google和Facebook的登录和分享，所以需要将GoogleSignIn.bundle、GoogleSignIn.framework、GoogleSignInDependencies.framework; FBSDKLoginKit.framework、FBSDKShareKit.framework、FBSDKCoreKit.framework、Bolts.framework这些文件一起copy到项目。

其中ZBGameSDK.framework和ZBGameSDK.bundle就是需要用到的动态库和资源文件。

[图片上传中...(无标题.png-83cecf-1533607190549-0)]

---

二、开始使用

1、将所需的文件拖进自己的项目

无标题.png

2、在自己的项目里选择Target -> General -> Embedded Binaries，点击 ‘+’，然后把ZBGameSDK.framework添加进来

无标题.png

3、导入SDK的头文件#import

---

三、登录模块

1、登录、注册、一键登录、找回密码、绑定邮箱都在ZBLoginVC集成了。直接创建ZBLoginVC对象，然后present该vc。

ZBLoginVC *vc = [ZBLoginVC new];
[controller presentViewController:vc animated:NO completion:nil];

ZBLoginVC有如下代理方法
当用账号登录成功时会调用如下代理方法：

-   (void)userLoginSuccess:(ZBLoginVC *)loginVC;

当游客登录成功时会调用如下代理方法：

- (void)visitorLoginSuccessful:(ZBLoginVC *)loginVC;

当用第三方登录成功时会调用如下代理方法：

- (void)thirdPartLoginSuccess:(ZBLoginVC *)loginVC;

2、Facebook登录

1）、Facebook登录需要去https://developers.facebook.com/docs/facebook-login/ios创建一个Facebook应用。

2）、创建好了应用之后，请配置 info.plist（不会的话，请看Facebook官方文档）。

3）、配置好info.plist之后，在Appdelegate.m中的- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法里添加

[[ZBFacebookLoginTool sharedZBFacebookLoginTool]initialFBSDKWtihApplication:application options:launchOptions];

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [[ZBFacebookLoginTool sharedZBFacebookLoginTool]initialFBSDKWtihApplication:application options:launchOptions];
    
    return YES;
}

4）、在Appdelegate.m中的- (BOOL)application:(UIApplication *)applicationo penURL:(NSURL *)url options:(NSDictionary *)options方法里添加

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary *)options {
    
    [[ZBFacebookLoginTool sharedZBFacebookLoginTool] facebookApplication:application openURL:url options:options];
    
    return YES;
}

5）、然后在需要Facebook登录的地方添加如下代码进行登录

[[ZBFacebookLoginTool sharedZBFacebookLoginTool]loginWithController:self success:^(NSString *userID) {     
     NSLog(@"......userID:%@", userID);    
 } failure:^(NSError *error){    
     NSLog(@"......failure");     
}];

3、Google登录。

1）、Google登录功能首先需要去https://console.developers.google.com/projectselector/apis/credentials?supportedpurview=project创建一个应用（如果没有Google开发者账号请自行注册）。

2）、创建好了一个应用后，在Xcode中的info里添加Google的URL Scheme

无标题.png

3）、在Appdelegate.m中的- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法里添加

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // Google登录
    [[ZBGoogleLoginTool sharedZBGoogleLoginTool] registerGoogleClientID:@"680967176958-gscakqo5juif6226rfft5u3jgjmq109q.apps.googleusercontent.com"];
    
    return YES;
}

4）、在Appdelegate.m中的- (BOOL)application:(UIApplication *)applicationo penURL:(NSURL *)url options:(NSDictionary *)options方法里添加

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary *)options {
    
    [[ZBGoogleLoginTool sharedZBGoogleLoginTool] hanleOpenURL:url options:options];
    
    return YES;
}

5）、然后在需要Google登录的地方添加如下代码进行登录

[[ZBGoogleLoginTool sharedZBGoogleLoginTool]loginWithController:self Success:^(NSString *userID) {        
       NSLog(@"......suerid:%@", userID);  
   } failure:^(NSError *error){  
       NSLog(@"......error:");    
 }]; 

4、Line登录

1）、先去Line开发者中心注册一个应用https://developers.line.me/console/。

2）、在- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary *)options方法中添加hanleOpenURL

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary *)options {
    //
    [[ZBLineManager sharedZBLineManager] handleOpenURL:url];
   
    return YES;
}

/**
 Line登录
 */
- (void)lineLogin {
    
    [[ZBLineManager sharedZBLineManager]loginWithSuccess:^(ZBLineUser *user) {
        
        NSLog(@"......userNmae:%@", user.displayName);
        NSLog(@"......userID:%@", user.userID);
        NSLog(@"......userPicture:%@", user.pictureURLStr);
        
    } failure:^(NSError *error) {
        NSLog(@"......error:%@", error);
    }];
    
}

---

四、锚点

1、安装锚点

[ZBGameAnchor installAnchorSuccess:^(ZBModel *model) {  
       NSLog(@"......:%@", model.msg);   
  } failure:^(NSError *error) {     
       NSLog(@"......error:%@", error);   
  }];

2、激活锚点

[ZBGameAnchor activationAchorSuccess:^(ZBModel *model) {     
      NSLog(@"......:%@", model.msg);  
   } failure:^(NSError *error) {   
      NSLog(@"......error:%@", error);
   }];

3、创角锚点

[ZBGameAnchor createRoleAnchorSuccess:^(ZBModel *model) {         
NSLog(@"......:%@", model.msg);  
   } failure:^(NSError *error) {
         NSLog(@"......error:%@", error); 
    }];

4、Facebook事件记录。自行到Facebook开发者中心https://developers.facebook.com去创建自己的应用。

ZBFacebookManager这个类是用来做Facebook事件记录

// 激活事件
/**
 ActivatedApp Event
 */
+ (void)activatedAppEvent; // 激活

// 注册事件

/**
 CompletedRegistration Event

 @param registrationMethod registrationMethod
 */
 +(void)completedRegistrationEvent :(NSString*)registrationMethod; 

// 实现关卡事件
/**
 AchievedLevel Event
 
 @param level level
 */
+ (void)achievedLevelEvent:(NSString*)level;

// 支付记录事件（用来记录有支付这个动作）
+ (void)purchasedEvent:(int)numItems
              contentType:(NSString*)contentType
                contentId:(NSString*)contentId
                 currency:(NSString*)currency
                 valToSum:(double)price;

// 支付结果事件（用来记录支付结果）
+ (void)pymentInfo:(BOOL)success;

5、Adjust事件记录，去https://www.adjust.com中自行注册自己的应用

ZBAdvertisingManager这个类实现Adjust的事件记录

// Application的didlaunch方法中初始化Adjust 
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    // Adjust
    [ZBAdvertisingManager registerAdjustWhenAppDidLaunch:application adjustToken:@"iiyrnfdbxf5s" adjEnvironment:ZBAdjustEveironmentSanbox];
    
    return YES;
}

// 记录事件方法
+ (void)eventWithEventToken:(NSString *)token;

---

五、支付，目前有两大类支付：一是APP内购；另外是第三方支付。这两种都集成在

ZBPaySelectManager里。

使用时只需掉用

+ (void)showPayAlertWithVC:(UIViewController *)vc
                 productID:(NSString *)productID
                 gameParam:(NSString *)gameParam
               cpProductID:(NSString *)cpProductID
                 cpOrderID:(NSString *)cpOrderID
                   success:(void(^)(NSInteger diamonds, BOOL isInAppPurchase))success
                   failure:(void(^)(NSError *error))failure;

在回调的block里处理相应的支付结果。

六、广告

1、Admob广告，首先要自行去https://apps.admob.com中心创建自己的应用。由ZBAdmobManager类实现该功能

1)、首先要初始化、加载广告

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
 
    // Admob
    // 初始化
    [[ZBAdmobManager sharedZBAdmobManager] configureWithAppID:@"ca-app-pub-3940256099942544~1458002511"];
    
    // 加载广告
    [[ZBAdmobManager sharedZBAdmobManager] loadRequestWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"];
    
    return YES;
}

2）、展示广告

- (IBAction)presentAD {
    [[ZBAdmobManager sharedZBAdmobManager] presentADVideoFromViewController:self];
}

2、Unity广告,首先自行创建自己的unity应用https://developer.cloud.unity3d.com。unity广告由ZBUnityManager该类来实现。

1）、初始化，在使用该广告之前先初始化

[[ZBUnityManager sharedZBUnityManager] initializeWithGameID:@"26***74"];

2)、展示广告

[[ZBUnityManager sharedZBUnityManager] showUnityWithPlacementId:@"Your PlacementId" controller:self];

七、分享

1、 分享URL，Google和Facebook分享

[ZBShareTool shareLink:@"http://baidu.com" controller:self];

2、 图片分享，只有Facebook可分享

UIImage *image = [UIImage imageNamed:@"agree"];
    [ZBShareTool shareImage:image controller:self];

八、选择游戏服和角色

1、选择游戏服用ZBSelectGameServerManager这个类

- (void)selectGameServerManagerWithGameServerID:(nonnull NSString *)gameServerID
                                 gameServerName:(nonnull NSString *)gameServerName
                                        success:(void(^)(void))success
                                        failure:(void(^)(NSString *errorString))failure;

ZBSelectGameServerManager *server = [ZBSelectGameServerManager sharedZBSelectGameServerManager;
    
    [server selectGameServerManagerWithGameServerID:@"123" gameServerName:@"游戏服" success:^{
        NSLog(@"成功");
        
    } failure:^(NSString *errorString) {
        NSLog(@"失败：%@", errorString);
    }];

2、选择角色用ZBSelectRoleManager这个类

ZBSelectRoleManager *roleManager = [ZBSelectRoleManager sharedZBSelectRoleManager];
    [roleManager selectRoleWithRoleName:@"角色名" success:^{
        NSLog(@"角色成功");
        
    } failure:^(NSString *errorString) {
        NSLog(@"角色失败:%@", errorString);
        
    }];