Cocos2d之接入GameCenter

发表于 | | 阅读次数: |
字数统计: 1,773 字 | 阅读时长 ≈ 8 分钟

Cocos2d接入GameCenter 排行榜与成就


前言

要求接入GameCenter的排行榜和成就。

GameCenter 是苹果推出的一个社交平台，
它主要提供了以下几个功能：

  • 排行榜
  • 成就
  • 挑战

而且，苹果同时提供了GameKit框架来让GameCenter更易集成。
可能是因为GameCenter的热度过去了吧，相关的东西都比较早期。
整理总结了一下，希望对他人有所帮助。

环境：

  • XCode 8.3

  • Cocos2dx-lua



公共的处理

配置 iTunes Connect 排行榜与成就的位置。

登录iTunes Connect, 找到要处理的APP。
选择 功能->GameCenter
可以看到三个大项：

  • 移动群组
  • 排行榜
  • 成就

添加GameKit框架

打开项目工程，将 Capabilities 的 GameCenter 打开。
这样，XCode就会将GameKit框架加到我们的工程中。

登录GameCenter

登录GameCenter: 【这个步骤在我们加载完游戏时进行即可】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
-(void) authenticateLocalPlayer {
    // 获取本地用户
    GKLocalPlayer* localPlayer = [GKLocalPlayer localPlayer];

    // 认证登录
    localPlayer.authenticateHandler = ^(UIViewController *viewController, NSError *error) {
        [self setLastError:error];

        if (localPlayer.authenticated) {                        // 本地用户已经登录
            _gameCenterFeaturesEnabled = YES;                   // 此变量是判断是否已经登录上GameCenter
        } else if(viewController) {                             // 没有用户，弹出登录界面
            [self presentViewController:viewController];        
        } else {                                                // 没有用户，并且没有登录界面
            _gameCenterFeaturesEnabled = NO;
        }
    };
}

关于lua调用object-c

因为我的环境是 cocos2d-x lua，所以，用通过lua来调用object-c。
cocos2d-x其实已经有相关的调用结构 —— LuaObjcBridge, 可以直接用 callStaticMethod来调用：

1
LuaObjcBridge.callStaticMethod(methodName className,args)

GameKit辅助处理类

GameKitHelper.h:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
#import <GameKit/GameKit.h>
#import "cocos2d.h"

// 方便lua调用
#include "CCLuaEngine.h"
#include "CCLuaBridge.h"

@interface GameKitHelper : NSObject
// 处理错误
@property (nonatomic, readonly) NSError* lastError;

// 初始化
+ (id) sharedGameKitHelper;

// Player authentication, info
-(void) authenticateLocalPlayer;
@end

GameKitHelper.mm

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
#import "GameKitHelper.h"

@interface GameKitHelper ()
        <GKGameCenterControllerDelegate> {
    BOOL _gameCenterFeaturesEnabled;
}
@end

@implementation GameKitHelper

#pragma mark Singleton stuff

+(id) sharedGameKitHelper {
    static GameKitHelper *sharedGameKitHelper;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        sharedGameKitHelper =
                [[GameKitHelper alloc] init];
    });
    return sharedGameKitHelper;
}

#pragma mark Player Authentication

-(void) authenticateLocalPlayer {
    GKLocalPlayer* localPlayer = [GKLocalPlayer localPlayer];

    localPlayer.authenticateHandler = ^(UIViewController *viewController, NSError *error) {
        [self setLastError:error];
        if (localPlayer.authenticated) {
            _gameCenterFeaturesEnabled = YES;
        } else if(viewController) {
            [self presentViewController:viewController];
        } else {
            _gameCenterFeaturesEnabled = NO;
        }
    };
}

#pragma mark Property setters

-(void) setLastError:(NSError*)error {
    _lastError = [error copy];
    if (_lastError) {
        NSLog(@"GameCenter -- setLastError -- ERROR: %@", [[_lastError userInfo] 
          description]);
    }
}

#pragma mark UIViewController stuff

-(UIViewController*) getRootViewController {
    return [UIApplication 
      sharedApplication].keyWindow.rootViewController;
}

-(void)presentViewController:(UIViewController*)vc {
    UIViewController* rootVC = [self getRootViewController];
    [rootVC presentViewController:vc animated:YES 
      completion:nil];
}

@end

登录GameCenter时机

由你决定，可以放在 AppDelegate 中 applicationDidFinishLaunching时。



关于排行榜

配置 iTunes Connect

在iTunes Connect 找到 排行榜。

简单说一下流程吧：
配置排行榜的结构，然后我们在游戏中将数据上传到这个结构，最后显示到GameCenter中。

排行榜分为 单个排行榜 与 组合排行榜。(顾名思义，区别就不需要解释了吧？)
里面需要配置的相应属性，可参考本文末尾的关于。

要注意两点：

  1. 排行榜ID，因为只有它是在创建后无法更改的。（而且，要记住这个ID，因为后面程序要用到）
  2. 排行榜只要发布了（经过审批发布），就无法删除了。

接下来就看属性去配置它吧。

XCode工程配置

模拟这个流程：登录GameCenter -> 提交排行榜数据 ( -> 如果需要，弹出GameCenter排行榜)
提交排行榜数据:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
-(void) submitScore:(int64_t)score category:(NSString*)category {       // 这里两个参数 score是数据， category是ID，就是我们创建排行榜以后，不可更改的那个ID。
    // 检查是否在登录状态
    if (!_gameCenterFeaturesEnabled)    {
        NSLog(@"GameCenter -- submitScore -- Player not authenticated");
        return;
    }

    // 创建一个分数对象
    GKScore* gkScore = [[GKScore alloc] initWithCategory:category];

    // 设置分数对象的值
    gkScore.value = score;

    // 向GameCenter提交数据
    [gkScore reportScoreWithCompletionHandler: ^(NSError* error)    {
        [self setLastError:error];
    }];
}

实践使用

在公用部分，已经添加了GameCenter的登录验证相关的东西了。

  • 将排行榜数据提交的函数

GameKitHelper.h

1
-(void) submitScore:(int64_t)score category:(NSString*)category;

GameKitHelper.mm

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
-(void) submitScore:(int64_t)score category:(NSString*)category {

    if (!_gameCenterFeaturesEnabled)    {
        NSLog(@"GameCenter -- submitScore -- Player not authenticated");
        return;
    }

    GKScore* gkScore = [[GKScore alloc] initWithCategory:category];

    gkScore.value = score;

    [gkScore reportScoreWithCompletionHandler: ^(NSError* error)    {
        [self setLastError:error];
    }];
}
  • 给lua调用的函数

GameKitHelper.h

1
+(void) getScore:(NSDictionary *)dict;

GameKitHelper.mm

1
2
3
4
5
6
+(void) getScore:(NSDictionary *)dict {
    NSString* rID = [dict objectForKey:@"id"];
    int score = [[dict objectForKey:@"score"] intValue];
    
    [[GameKitHelper sharedGameKitHelper] submitScore:(int64_t)score category:rID];
}
  • lua调用
1
LuaObjcBridge.callStaticMethod("GameKitHelper", "getScore", {id = 排行榜的ID, score = 分数值})



关于成就

配置 iTunes Connect

还是老位置，之前看的排行榜，这次点成就。
还是老样子，成就的ID，创建后不可修改，成就发布后不可删除。
但是，成就还要多一点，就是每个游戏总共有2000点成就分（为什么是2000？你问老乔去。。），你可以给每个成就分配一些成就分。
成就还有是否隐藏的选项，但是它的隐藏并不是看不到这个成就了，而是有一个成就名称为隐藏的成就显示在列表中。
还有，它的进度是一个顺时针扇形来表示，就是你的图标刚开始是被遮掩的，随着进度的增加，会逐渐显现出图标，方向是顺时针扇形。

其他相关参数，可参考本文末尾的关于。

XCode工程配置

流程与排行榜的一样，但是这次提交的不是分数了，而是成就完成的百分比。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// 提交成就数据
-(void) submitAchievment:(NSString *)identifier percent:(double) percentComplete {          // identifier 成就ID, percentComplete: 成就完成百分比
    // 判断登录认证
    if (!_gameCenterFeaturesEnabled)    {
        NSLog(@"GameCenter -- submitAchievment -- Player not authenticated");
        return;
    }

    // 创建成就结构，注入成就ID
    GKAchievement *achievement = [[GKAchievement alloc] initWithIdentifier:identifier];  
    
    // 设置成就百分比
    [achievement setPercentComplete:percentComplete];  
    
    // 提交成就数据
    [achievement reportAchievementWithCompletionHandler:^(NSError *error) {  
        if(error != nil){  
            NSLog(@"GameCenter -- submitAchievment --  error:%@", [error localizedDescription]);  
        }else{  
            NSLog(@"GameCenter -- submitAchievment --  提交成就成功");  
        }  
    }];  
}

实践使用

同排行榜一样。

  • 将成就数据提交的函数

GameKitHelper.h

1
- (void)submitAchievment:(NSString *)identifier percent:(double)percentComplete;

GameKitHelper.mm

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
-(void) submitAchievment:(NSString *)identifier percent:(double) percentComplete {
    if (!_gameCenterFeaturesEnabled)    {
        NSLog(@"GameCenter -- submitAchievment -- Player not authenticated");
        return;
    }

    GKAchievement *achievement = [[GKAchievement alloc] initWithIdentifier:identifier];  
      
    [achievement setPercentComplete:percentComplete];  
      
    [achievement reportAchievementWithCompletionHandler:^(NSError *error) {  
        if(error != nil){  
            NSLog(@"GameCenter -- submitAchievment --  error:%@", [error localizedDescription]);  
        }else{  
            NSLog(@"GameCenter -- submitAchievment --  提交成就成功");  
        }  
    }];  
}
  • 给lua调用的函数

GameKitHelper.h

1
+(void) getAchievement:(NSDictionary *)dict;

GameKitHelper.mm

1
2
3
4
5
6
+(void) getAchievement:(NSDictionary *)dict {
    NSString* aID = [dict objectForKey:@"id"];
    double percent = [[dict objectForKey:@"percent"] doubleValue];
    
    [[GameKitHelper sharedGameKitHelper] submitAchievment:(NSString *)aID percent:percent];
}
  • lua调用
1
LuaObjcBridge.callStaticMethod("GameKitHelper", "getAchievement", {id = 成就ID, percent = 成就百分比})



最后

GameCenter还是挺好的一个东西。
它还有一个好友挑战功能，但这个主要适合之前 Flappy Bird，别踩白块 那些游戏来弄。
或许，这也是这个平台没落了的原因吧。




参考资料