推荐到广播
610678 人聚集在这个小组
(忍野喵喵)
(小栗旬的鹅)
(代表月亮惩罚你)
第三方登录：GameCenter 使用指南
招聘信息：
& GameCenter 为单机游戏为主的 iPhone 游戏平台引入了社会化特性，更为将来的网游、多人竞技等游戏打下了基础。下面是 CocoaChina 会员 &ljg420811& 总结的 GameCenter 使用指南，包括 GameCenter 的设置和代码实现。
1.&&& iTunes Connect 设置
&&& 首先,申请一个应用程序,不必提交.目地是为了得到Bundle ID.
&&& 然后设置一下工程中Info.plist的Bundle identifier使之与iTunes Connect中的Bundle ID相同,否则当你尝试登录GameCenter的时候,会提示一个不支持GameCenter的错误.
&&& 申请完毕,打开你刚申请的application,点击Manage Game Center选项.
&&& 进入后点击Enable Game Center使你的Game Center生效.
&&& 接下来就可以设置自己的Leaderboard和Achievements.
2.&&& Leaderboard设置
&&& Leaderboard纵观图如下所示.
&&& 1.sort Order: Leaderboard中的内容是以升序还是降序排列.
&&& 2.Score Format Type:分数的类型.
&&& 3.*Categories:Leaderboard的一个分数榜,这个可以创建多个,比如游戏可以分为Easy,Normal,Hard三个难度,每个难度一个榜.
&&& *设置完成后保存,完成了一个 Leaderboard的设置.我们可以根据需要添加多个 leaderboard.
&&& 4.**Score Format Location: leaderboard支持的语言.
&&& **可以支持多种语言,每支持一种语言,需要完成一个上述操作.
这个时候右下角会出现save change按钮,点击完成leaderboard的设置.
你可以根据需要随时更改你的leaderboard,操作与上述内容类似.
3.&&& Achievements设置
&&& Achievements界面内容比较少,点击左上角的Add New Achievement,打开如下图所示的Achievements创建界面.
&&& Hidden:表示该成就为解锁前玩家是否可见.
&&& Achievement ID:程序通过这个属性来识别成就.
&&& *Achievement Localization:该成就支持的语言.
&&& *Achievement Localization设置如下图所示.
&&& *其中,成就的Image必须是512X512,72DPI的.
一切设置完成后,点击save change按钮即完成一个成就的设置.
4.总体功能
在使用各个功能前,你需要了解一下块函数。传送门:
4.1 对Game Center支持判断
&& 1. - (BOOL) isGameCenterAvailable
&& 3.&&&& Class gcClass = (NSClassFromString(@"GKLocalPlayer"));
&& 4.&&&& NSString *reqSysVer = @"4.1";
&& 5.&&&& NSString *currSysVer = [[UIDevice currentDevice] systemVersion];
&& 6.&&&& BOOL osVersionSupported = ([currSysVer compare:reqSysVer options:NSNumericSearch] != NSOrderedAscending);
&& 8.&&&& return (gcClass && osVersionSupported);
4.2用户登录
&& 1. - (void) authenticateLocalPlayer
&& 3.&&&& [[GKLocalPlayer localPlayer] authenticateWithCompletionHandler:^(NSError *error){
&& 4.&&&&&&&& if (error == nil) {
&& 5.&&&&&&&&&&&& //成功处理
&& 6.&&&&&&&&&&&& NSLog(@"成功");
&& 7.&&&&&&&&&&&& NSLog(@"1--alias--.%@",[GKLocalPlayer localPlayer].alias);
&& 8.&&&&&&&&&&&& NSLog(@"2--authenticated--.%d",[GKLocalPlayer localPlayer].authenticated);
&& 9.&&&&&&&&&&&& NSLog(@"3--isFriend--.%d",[GKLocalPlayer localPlayer].isFriend);
& 10.&&&&&&&&&&&& NSLog(@"4--playerID--.%@",[GKLocalPlayer localPlayer].playerID);
& 11.&&&&&&&&&&&& NSLog(@"5--underage--.%d",[GKLocalPlayer localPlayer].underage);
& 12.&&&&&&&& }else {
& 13.&&&&&&&&&&&& //错误处理
& 14.&&&&&&&&&&&& NSLog(@"失败& %@",error);
& 15.&&&&&&&& }
& 16.&&&& }];
对于开发者来说,Game Center必须经过测试才能上线,没有上线的程序在测试环境中登录时会出现sandbox提示.如图.
4.3用户变更检测
由于4.0以后系统支持多任务,玩家的机器有可能被不同的玩家接触,导致Game Center上的用户发生变化,当发生变化的时候,程序必须在游戏中通知玩家.
&& 1. - (void) registerForAuthenticationNotification
&& 3.&&&& NSNotificationCenter *nc = [NSNotificationCenter defaultCenter];
&& 4.&&&& [nc addObserver:self
&& 5.&&&&&&&&&&& selector:@selector(authenticationChanged)
&& 6.&&&&&&&&&&&&&&& name:GKPlayerAuthenticationDidChangeNotificationName
&& 7.&&&&&&&&&&&&& object:nil];
& 10. - (void) authenticationChanged
& 12.&&&& if ([GKLocalPlayer localPlayer].isAuthenticated)
& 13.&&&& {
& 14.&&&&&&&& ;// Insert code here to handle a successful authentication.
& 15.&&&& }
& 16.&&&& else
& 17.&&&& {
& 18.&&&&&&&& ;// Insert code here to clean up any outstanding Game Center-related classes.
& 19.&&&& }
5.对Leaderboard进行操作
5.1上传一个分数
&& 1. - (void) reportScore: (int64_t) score forCategory: (NSString*) category
&& 3.&&&& GKScore *scoreReporter = [[[GKScore alloc] initWithCategory:category] autorelease];
&& 4.&&&& scoreReporter.value =
&& 6.&&&& [scoreReporter reportScoreWithCompletionHandler:^(NSError *error) {
&& 7.&&&&&&&& if (error != nil)
&& 8.&&&&&&&& {
&& 9.&&&&&&&&&&&& // handle the reporting error
& 10.&&&&&&&&&&&& NSLog(@"上传分数出错.");
& 11.&&&&&&&&&&&& //If your application receives a network error, you should not discard the score.
& 12.&&&&&&&&&&&& //Instead, store the score object and attempt to report the player&s process at
& 13.&&&&&&&&&&&& //a later time.
& 14.&&&&&&&& }else {
& 15.&&&&&&&&&&&& NSLog(@"上传分数成功");
& 16.&&&&&&&& }
& 18.&&&& }];
当上传分数出错的时候,要将上传的分数存储起来,比如将SKScore存入一个NSArray中.等可以上传的时候再次尝试.
5.2下载一个分数
&& 1. //GKScore objects provide the data your application needs to create a custom view.
&& 2. //Your application can use the score object&s playerID to load the player&s alias.
&& 3. //The value property holds the actual value you reported to Game Center. the formattedValue
&& 4. //property provides a string with the score value formatted according to the parameters
&& 5. //you provided in iTunes Connect.
&& 6. - (void) retrieveTopTenScores
&& 8.&&&& GKLeaderboard *leaderboardRequest = [[GKLeaderboard alloc] init];
&& 9.&&&& if (leaderboardRequest != nil)
& 10.&&&& {
& 11.&&&&&&&& leaderboardRequest.playerScope = GKLeaderboardPlayerScopeG
& 12.&&&&&&&& leaderboardRequest.timeScope = GKLeaderboardTimeScopeAllT
& 13.&&&&&&&& leaderboardRequest.range = NSMakeRange(1,10);
& 14.&&&&&&&& leaderboardRequest.category = @"TS_LB";
& 15.&&&&&&&& [leaderboardRequest loadScoresWithCompletionHandler: ^(NSArray *scores, NSError *error) {
& 16.&&&&&&&&&&&& if (error != nil){
& 17.&&&&&&&&&&&&&&&& // handle the error.
& 18.&&&&&&&&&&&&&&&& NSLog(@"下载失败");
& 19.&&&&&&&&&&&& }
& 20.&&&&&&&&&&&& if (scores != nil){
& 21.&&&&&&&&&&&&&&&& // process the score information.
& 22.&&&&&&&&&&&&&&&& NSLog(@"下载成功....");
& 23.&&&&&&&&&&&&&&&& NSArray *tempScore = [NSArray arrayWithArray:leaderboardRequest.scores];
& 24.&&&&&&&&&&&&&&&& for (GKScore *obj in tempScore) {
& 25.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& playerID&&&&&&&&&&& : %@",obj.playerID);
& 26.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& category&&&&&&&&&&& : %@",obj.category);
& 27.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& date&&&&&&&&&&&&&&& : %@",obj.date);
& 28.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& formattedValue&&& : %@",obj.formattedValue);
& 29.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& value&&&&&&&&&&&&&&& : %d",obj.value);
& 30.&&&&&&&&&&&&&&&&&&&& NSLog(@"&&& rank&&&&&&&&&&&&&&& : %d",obj.rank);
& 31.&&&&&&&&&&&&&&&&&&&& NSLog(@"**************************************");
& 32.&&&&&&&&&&&&&&&& }
& 33.&&&&&&&&&&&& }
& 34.&&&&&&&& }];
& 35.&&&& }
1)&&& playerScope:表示检索玩家分数范围.
2)&&& timeScope:表示某一段时间内的分数
3)&&& range:表示分数排名的范围
4)&&& category:表示你的Leaderboard的ID.
5.3玩家信息交互
Game Center最重要的一个功能就是玩家交互.所以,必须检索已经登录玩家的好友信息.根据自己的需要做出设置,比如,可以与好友比较分数,或者好友排行榜等.
//检索已登录用户好友列表
&& 1. - (void) retrieveFriends
&& 3.&&&& GKLocalPlayer *lp = [GKLocalPlayer localPlayer];
&& 4.&&&& if (lp.authenticated)
&& 5.&&&& {
&& 6.&&&&&&&& [lp loadFriendsWithCompletionHandler:^(NSArray *friends, NSError *error) {
&& 7.&&&&&&&&&&&& if (error == nil)
&& 8.&&&&&&&&&&&& {
&& 9.&&&&&&&&&&&&&&&& [self loadPlayerData:friends];
& 10.&&&&&&&&&&&& }
& 11.&&&&&&&&&&&& else
& 12.&&&&&&&&&&&& {
& 13.&&&&&&&&&&&&&&&& ;// report an error to the user.
& 14.&&&&&&&&&&&& }
& 15.&&&&&&&& }];
& 16.&&&&&&&&
& 17.&&&& }
上面的friends得到的只是一个身份列表,里面存储的是NSString,想要转换成好友ID,必须调用- (void) loadPlayerData: (NSArray *) identifiers方法,该方法得到的array里面存储的才是GKPlayer对象.如下
&& 2. Whether you received player identifiers by loading the identifiers for the local player&s
&& 3. friends, or from another Game Center class, you must retrieve the details about that player
&& 4. from Game Center.
&& 6. - (void) loadPlayerData: (NSArray *) identifiers
&& 8.&&&& [GKPlayer loadPlayersForIdentifiers:identifiers withCompletionHandler:^(NSArray *players, NSError *error) {
&& 9.&&&&&&&& if (error != nil)
& 10.&&&&&&&& {
& 11.&&&&&&&&&&&& // Handle the error.
& 12.&&&&&&&& }
& 13.&&&&&&&& if (players != nil)
& 14.&&&&&&&& {
& 15.&&&&&&&&&&&& NSLog(@"得到好友的alias成功");
& 16.&&&&&&&&&&&& GKPlayer *friend1 = [players objectAtIndex:0];
& 17.&&&&&&&&&&&& NSLog(@"friedns---alias---%@",friend1.alias);
& 18.&&&&&&&&&&&& NSLog(@"friedns---isFriend---%d",friend1.isFriend);
& 19.&&&&&&&&&&&& NSLog(@"friedns---playerID---%@",friend1.playerID);
& 20.&&&&&&&& }
& 21.&&&& }];
至此,leaderboard功能介绍完毕
6.对Achievement进行操作
& 这一部分内容比较多,而且有的地方有点重复的感觉.
6.1汇报一个成就的进度
& 对于一个玩家可见的成就,你需要尽可能的报告给玩家解锁的进度;对于一个一部完成的成就,则不需要,当玩家的进度达到100%的时候,会自动解锁该成就.
&& 1. - (void) reportAchievementIdentifier: (NSString*) identifier percentComplete: (float) percent
&& 3.&&&& GKAchievement *achievement = [[[GKAchievement alloc] initWithIdentifier: identifier] autorelease];
&& 4.&&&& if (achievement)
&& 5.&&&& {
&& 6.&&&&&&&& achievement.percentComplete =
&& 7.&&&&&&&& [achievement reportAchievementWithCompletionHandler:^(NSError *error)
&& 8.&&&&&&&&& {
&& 9.&&&&&&&&&&&&& if (error != nil)
& 10.&&&&&&&&&&&&& {
& 11.&&&&&&&&&&&&&&&&& //The proper way for your application to handle network errors is retain
& 12.&&&&&&&&&&&&&&&&& //the achievement object (possibly adding it to an array). Then, periodically
& 13.&&&&&&&&&&&&&&&&& //attempt to report the progress until it is successfully reported.
& 14.&&&&&&&&&&&&&&&&& //The GKAchievement class supports the NSCoding protocol to allow your
& 15.&&&&&&&&&&&&&&&&& //application to archive an achie
& 16.&&&&&&&&&&&&&&&&& NSLog(@"报告成就进度失败 ,错误信息为: \n %@",error);
& 17.&&&&&&&&&&&&& }else {
& 18.&&&&&&&&&&&&&&&&& //对用户提示,已经完成XX%进度
& 19.&&&&&&&&&&&&&&&&& NSLog(@"报告成就进度---->成功!");
& 20.&&&&&&&&&&&&&&&&& NSLog(@"&&& completed:%d",pleted);
& 21.&&&&&&&&&&&&&&&&& NSLog(@"&&& hidden:%d",achievement.hidden);
& 22.&&&&&&&&&&&&&&&&& NSLog(@"&&& lastReportedDate:%@",achievement.lastReportedDate);
& 23.&&&&&&&&&&&&&&&&& NSLog(@"&&& percentComplete:%f",achievement.percentComplete);
& 24.&&&&&&&&&&&&&&&&& NSLog(@"&&& identifier:%@",achievement.identifier);
& 25.&&&&&&&&&&&&& }
& 26.&&&&&&&&& }];
& 27.&&&& }
其中该函数的参数中identifier是你成就的ID, percent是该成就完成的百分比
6.2读取一个成就
方法一:得到所有的成就
&& 1. - (void) loadAchievements
&& 3.&&&& NSMutableDictionary *achievementDictionary = [[NSMutableDictionary alloc] init];
&& 4.&&&& [GKAchievement loadAchievementsWithCompletionHandler:^(NSArray *achievements,NSError *error)
&& 5.&&&&& {
&& 6.&&&&&&&&& if (error == nil) {
&& 7.&&&&&&&&&&&&& NSArray *tempArray = [NSArray arrayWithArray:achievements];
&& 8.&&&&&&&&&&&&& for (GKAchievement *tempAchievement in tempArray) {
&& 9.&&&&&&&&&&&&&&&&& [achievementDictionary setObject:tempAchievement forKey:tempAchievement.identifier];
& 10.&&&&&&&&&&&&&&&&& NSLog(@"&&& completed:%d",pleted);
& 11.&&&&&&&&&&&&&&&&& NSLog(@"&&& hidden:%d",tempAchievement.hidden);
& 12.&&&&&&&&&&&&&&&&& NSLog(@"&&& lastReportedDate:%@",tempAchievement.lastReportedDate);
& 13.&&&&&&&&&&&&&&&&& NSLog(@"&&& percentComplete:%f",tempAchievement.percentComplete);
& 14.&&&&&&&&&&&&&&&&& NSLog(@"&&& identifier:%@",tempAchievement.identifier);
& 15.&&&&&&&&&&&&& }
& 16.&&&&&&&&& }
& 17.&&&&& }];
函数中NSArray返回的是你的所有成就ID.
方法二:根据ID获取成就
&& 1. - (GKAchievement*) getAchievementForIdentifier: (NSString*) identifier
&& 3.&&&& NSMutableDictionary *achievementDictionary = [[NSMutableDictionary alloc] init];
&& 4.&&&& GKAchievement *achievement = [achievementDictionary objectForKey:identifier];
&& 5.&&&& if (achievement == nil)
&& 6.&&&& {
&& 7.&&&&&&&& achievement = [[[GKAchievement alloc] initWithIdentifier:identifier] autorelease];
&& 8.&&&&&&&& [achievementDictionary setObject:achievement forKey:achievement.identifier];
&& 9.&&&& }
& 10.&&&& return [[achievement retain] autorelease];
6.3获取成就描述和图片
在自定义界面中,玩家需要一个成就描述,以及该成就的图片,Game Center提供了该功能.当然,你也可以自己在程序中完成,毕竟玩家不可能时刻处于在线状态.
&& 1. - (NSArray*)retrieveAchievmentMetadata
&& 3.&&&& //读取成就的描述
&& 4.&&&& [GKAchievementDescription loadAchievementDescriptionsWithCompletionHandler:
&& 5.&&&&& ^(NSArray *descriptions, NSError *error) {
&& 6.&&&&&&&&& if (error != nil)
&& 7.&&&&&&&&& {
&& 8.&&&&&&&&&&&&& // process the errors
&& 9.&&&&&&&&&&&&& NSLog(@"读取成就说明出错");
& 10.&&&&&&&&& }
& 11.&&&&&&&&& if (descriptions != nil)
& 12.&&&&&&&&& {
& 13.&&&&&&&&&&&&& // use the achievement descriptions.
& 14.&&&&&&&&&&&&& for (GKAchievementDescription *achDescription in descriptions) {
& 15.&&&&&&&&&&&&&&&&& NSLog(@"1..identifier..%@",achDescription.identifier);
& 16.&&&&&&&&&&&&&&&&& NSLog(@"2..achievedDescription..%@",achDescription.achievedDescription);
& 17.&&&&&&&&&&&&&&&&& NSLog(@"3..title..%@",achDescription.title);
& 18.&&&&&&&&&&&&&&&&& NSLog(@"4..unachievedDescription..%@",achDescription.unachievedDescription);
& 19.&&&&&&&&&&&&&&&&& NSLog(@"5............%@",achDescription.image);
& 20.&&&&&&&&&&&&&&&&
& 21.&&&&&&&&&&&&&&&&& //获取成就图片,如果成就未解锁,返回一个大文号
& 22.&&&&&&&&&&&&&&&&& /*
& 23.&&&&&&&&&&&&&&&&& [achDescription loadImageWithCompletionHandler:^(UIImage *image, NSError *error) {
& 24.&&&&&&&&&&&&&&&&&&&&& if (error == nil)
& 25.&&&&&&&&&&&&&&&&&&&&& {
& 26.&&&&&&&&&&&&&&&&&&&&&&&&& // use the loaded image. The image property is also populated with the same image.
& 27.&&&&&&&&&&&&&&&&&&&&&&&&& NSLog(@"成功取得成就的图片");
& 28.&&&&&&&&&&&&&&&&&&&&&&&&& UIImage *aImage =
& 29.&&&&&&&&&&&&&&&&&&&&&&&&& UIImageView *aView = [[UIImageView alloc] initWithImage:aImage];
& 30.&&&&&&&&&&&&&&&&&&&&&&&&& aView.frame = CGRectMake(50, 50, 200, 200);
& 31.&&&&&&&&&&&&&&&&&&&&&&&&& aView.backgroundColor = [UIColor clearColor];
& 32.&&&&&&&&&&&&&&&&&&&&&&&&& [[[CCDirector sharedDirector] openGLView] addSubview:aView];
& 33.&&&&&&&&&&&&&&&&&&&&& }else {
& 34.&&&&&&&&&&&&&&&&&&&&&&&&& NSLog(@"获得成就图片失败");
& 35.&&&&&&&&&&&&&&&&&&&&& }
& 36.&&&&&&&&&&&&&&&&& }];
& 37.&&&&&&&&&&&&&&&&&& */
& 38.&&&&&&&&&&&&& }
& 39.&&&&&&&&& }
& 40.&&&& }];
如果你不主动使用注释中的方法,那么你得到的description中不会有图片,这样可以减少网络的使用,尽量少下载东西.当使用注释中的代码时,如果成就已经解锁,则返回该成就的图标,如果没有解锁,则返回一个大问号,至于未解锁图标是否可以自定义,我找寻的结果好像是不可以.
微信扫一扫
订阅每日移动开发及APP推广热点资讯公众号：CocoaChina
您还没有登录！请或
点击量7441点击量7096点击量6789点击量6705点击量6229点击量5835点击量4513点击量4467点击量4108
&2016 Chukong Technologies,Inc.
京公网安备89