cocos2d-x 接入 GameCenter 排行榜与成就
前言
要求接入GameCenter的排行榜和成就。
GameCenter 是苹果推出的一个社交平台，
它主要提供了以下几个功能：
- 排行榜
- 成就
- 挑战
而且，苹果同时提供了GameKit框架来让GameCenter更易集成。
可能是因为GameCenter的热度过去了吧，相关的东西都比较早期。
整理总结了一下，希望对他人有所帮助。
我的环境：
mac - XCode 8.3 - cocos2d-x lua
公共的处理
1. 配置 iTunes Connect 排行榜与成就的位置。
登录iTunes Connect, 找到要处理的APP。
选择 功能->GameCenter
可以看到三个大项：
- 移动群组
- 排行榜
- 成就
2. 添加GameKit框架
打开项目工程，将 Capabilities 的 GameCenter 打开。
这样，XCode就会将GameKit框架加到我们的工程中。
3. 登录GameCenter
登录GameCenter: 【这个步骤在我们加载完游戏时进行即可】
-(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;
}
};
}
4. 关于lua调用object-c
因为我的环境是 cocos2d-x lua，所以，用通过lua来调用object-c。
cocos2d-x其实已经有相关的调用结构 —— LuaObjcBridge, 可以直接用 callStaticMethod来调用：
LuaObjcBridge.callStaticMethod(methodName className,args)
5. GameKit辅助处理类
GameKitHelper.h:
#import
#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
#import "GameKitHelper.h"
@interface GameKitHelper ()
{
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
6. 登录GameCenter时机
由你决定，可以放在 AppDelegate 中 applicationDidFinishLaunching时。
关于排行榜
配置 iTunes Connect
在iTunes Connect 找到 排行榜。
简单说一下流程吧：
配置排行榜的结构，然后我们在游戏中将数据上传到这个结构，最后显示到GameCenter中。
排行榜分为 单个排行榜 与 组合排行榜。(顾名思义，区别就不需要解释了吧？)
里面需要配置的相应属性，可参考本文末尾的关于。
要注意两点：
- 排行榜ID，因为只有它是在创建后无法更改的。（而且，要记住这个ID，因为后面程序要用到）
- 排行榜只要发布了（经过审批发布），就无法删除了。
接下来就看属性去配置它吧。
XCode工程配置
模拟这个流程：登录GameCenter -> 提交排行榜数据 ( -> 如果需要，弹出GameCenter排行榜)
提交排行榜数据:
-(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
-(void) submitScore:(int64_t)score category:(NSString*)category;
GameKitHelper.mm
-(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
+(void) getScore:(NSDictionary *)dict;
GameKitHelper.mm
+(void) getScore:(NSDictionary *)dict {
NSString* rID = [dict objectForKey:@"id"];
int score = [[dict objectForKey:@"score"] intValue];
[[GameKitHelper sharedGameKitHelper] submitScore:(int64_t)score category:rID];
}
lua调用
LuaObjcBridge.callStaticMethod("GameKitHelper", "getScore", {id = 排行榜的ID, score = 分数值})
关于成就
配置 iTunes Connect
还是老位置，之前看的排行榜，这次点成就。
还是老样子，成就的ID，创建后不可修改，成就发布后不可删除。
但是，成就还要多一点，就是每个游戏总共有2000点成就分（为什么是2000？你问老乔去。。），你可以给每个成就分配一些成就分。
成就还有是否隐藏的选项，但是它的隐藏并不是看不到这个成就了，而是有一个成就名称为隐藏的成就显示在列表中。
还有，它的进度是一个顺时针扇形来表示，就是你的图标刚开始是被遮掩的，随着进度的增加，会逐渐显现出图标，方向是顺时针扇形。
其他相关参数，可参考本文末尾的关于。
XCode工程配置
流程与排行榜的一样，但是这次提交的不是分数了，而是成就完成的百分比。
// 提交成就数据
-(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
- (void)submitAchievment:(NSString *)identifier percent:(double)percentComplete;
GameKitHelper.mm
-(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
+(void) getAchievement:(NSDictionary *)dict;
GameKitHelper.mm
+(void) getAchievement:(NSDictionary *)dict {
NSString* aID = [dict objectForKey:@"id"];
double percent = [[dict objectForKey:@"percent"] doubleValue];
[[GameKitHelper sharedGameKitHelper] submitAchievment:(NSString *)aID percent:percent];
}
lua调用
LuaObjcBridge.callStaticMethod("GameKitHelper", "getAchievement", {id = 成就ID, percent = 成就百分比})
最后
GameCenter还是挺好的一个东西。
它还有一个好友挑战功能，但这个主要适合之前 Flappy Bird，别踩白块 那些游戏来弄。
或许，这也是这个平台没落了的原因吧。
关于
- 关于 LuaObjcBridge
- 关于 iTunes Connect
- 中文版 排行榜及成就 配置属性
参考
- https://www.raywenderlich.com/23189/whats-new-with-game-center-in-ios-6
- http://www.jianshu.com/p/4279f84d8340
- http://blog.csdn.net/shenjie12345678/article/details/45025403/