iOS开发必备指南合集之游戏接入GameCenter 指南

原地址：http://bbs.9ria.com/thread-248408-1-1.html

 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.*Categorieseaderboard的一个分数榜,这个可以创建多个,比如游戏可以分为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.总体功能
在使用各个功能前,你需要了解一下块函数。传送门:https://developer.apple.com/library/ios/#documentation/Cocoa/Conceptual/Blocks/Articles/00_Introduction.html

4.1 对Game Center支持判断

• 1.   - (BOOL) isGameCenterAvailable
  3.     {
  5.         Class gcClass = (NSClassFromString(@"GKLocalPlayer"));
  7.          NSString *reqSysVer = @"4.1";
  9.          NSString *currSysVer = [[UIDevice currentDevice] systemVersion];
  11.          BOOL osVersionSupported = ([currSysVer compare:reqSysVer options:NSNumericSearch] != NSOrderedAscending);
  13.         
  15.         return (gcClass && osVersionSupported);
  17.      }复制代码

  复制代码

4.2用户登录

• 1.   - (void) authenticateLocalPlayer
  3.      {
  5.          [[GKLocalPlayer localPlayer] authenticateWithCompletionHandler:^(NSError *error){
  7.             if (error == nil) {
  9.                 //成功处理
  11.                 NSLog(@"成功");
  13.                 NSLog(@"1--alias--.%@",[GKLocalPlayer localPlayer].alias);
  15.                  NSLog(@"2--authenticated--.%d",[GKLocalPlayer localPlayer].authenticated);
  17.                 NSLog(@"3--isFriend--.%d",[GKLocalPlayer localPlayer].isFriend);
  19.                 NSLog(@"4--playerID--.%@",[GKLocalPlayer localPlayer].playerID);
  21.                NSLog(@"5--underage--.%d",[GKLocalPlayer localPlayer].underage);
  23.            }else {
  25.                 //错误处理
  27.                NSLog(@"失败  %@",error);
  29.             }
  31.        }];
  33.     }复制代码

  复制代码

对于开发者来说,Game Center必须经过测试才能上线,没有上线的程序在测试环境中登录时会出现sandbox提示.如图.

                                  

4.3用户变更检测
由于4.0以后系统支持多任务,玩家的机器有可能被不同的玩家接触,导致Game Center上的用户发生变化,当发生变化的时候,程序必须在游戏中通知玩家.

1. - (void) registerForAuthenticationNotification
3.     {
5.         NSNotificationCenter *nc = [NSNotificationCenter defaultCenter];
7.         [nc addObserver:self
9.                selector:@selector(authenticationChanged)
11.                     name:GKPlayerAuthenticationDidChangeNotificationName
13.                  object:nil];
15.     }
17.     
19.    - (void) authenticationChanged
21.    {
23.         if ([GKLocalPlayer localPlayer].isAuthenticated)
25.         {
27.             ;// Insert code here to handle a successful authentication.
29.         }
31.        else
33.        {
35.            ;// Insert code here to clean up any outstanding Game Center-related classes.
37.       }
39.    }复制代码

复制代码

5.对Leaderboard进行操作
5.1上传一个分数

1.   - (void) reportScore: (int64_t) score forCategory: (NSString*) category
3.     {
5.        GKScore *scoreReporter = [[[GKScore alloc] initWithCategory:category] autorelease];
7.         scoreReporter.value = score;
9.         
11.          [scoreReporter reportScoreWithCompletionHandler:^(NSError *error) {
13.             if (error != nil)
15.             {
17.                // handle the reporting error
19.                 NSLog(@"上传分数出错.");
21.                //If your application receives a network error, you should not discard the score.
23.                //Instead, store the score object and attempt to report the player’s process at
25.                 //a later time.
27.             }else {
29.                NSLog(@"上传分数成功");
31.            }
33.    
35.        }];
37.     }复制代码

复制代码

当上传分数出错的时候,要将上传的分数存储起来,比如将SKScore存入一个NSArray中.等可以上传的时候再次尝试.

5.2下载一个分数

1.    //GKScore objects provide the data your application needs to create a custom view.
3.     //Your application can use the score object’s playerID to load the player’s alias.
5.      //The value property holds the actual value you reported to Game Center. the formattedValue
7.      //property provides a string with the score value formatted according to the parameters
9.      //you provided in iTunes Connect.
11.      - (void) retrieveTopTenScores
13.      {
15.         GKLeaderboard *leaderboardRequest = [[GKLeaderboard alloc] init];
17.        if (leaderboardRequest != nil)
19.         {
21.            leaderboardRequest.playerScope = GKLeaderboardPlayerScopeGlobal;
23.            leaderboardRequest.timeScope = GKLeaderboardTimeScopeAllTime;
25.            leaderboardRequest.range = NSMakeRange(1,10);
27.             leaderboardRequest.category = @"TS_LB";
29.             [leaderboardRequest loadScoresWithCompletionHandler: ^(NSArray *scores, NSError *error) {
31.                 if (error != nil){
33.                     // handle the error.
35.                     NSLog(@"下载失败");
37.                 }
39.                if (scores != nil){
41.                    // process the score information.
43.                    NSLog(@"下载成功....");
45.                   NSArray *tempScore = [NSArray arrayWithArray:leaderboardRequest.scores];
47.                     for (GKScore *obj in tempScore) {
49.                       NSLog(@"    playerID            : %@",obj.playerID);
51.                        NSLog(@"    category            : %@",obj.category);
53.                        NSLog(@"    date                : %@",obj.date);
55.                        NSLog(@"    formattedValue    : %@",obj.formattedValue);
57.                         NSLog(@"    value                : %d",obj.value);
59.                        NSLog(@"    rank                : %d",obj.rank);
61.                       NSLog(@"**************************************");
63.                     }
65.                 }
67.            }];
69.        }
71.    }复制代码

复制代码

说明:
1)    playerScope:表示检索玩家分数范围.
2)    timeScope:表示某一段时间内的分数
3)    range:表示分数排名的范围
4)    category:表示你的Leaderboard的ID.

5.3玩家信息交互
Game Center最重要的一个功能就是玩家交互.所以,必须检索已经登录玩家的好友信息.根据自己的需要做出设置,比如,可以与好友比较分数,或者好友排行榜等.
//检索已登录用户好友列表

1.     - (void) retrieveFriends
3.     {
5.         GKLocalPlayer *lp = [GKLocalPlayer localPlayer];
7.         if (lp.authenticated)
9.         {
11.             [lp loadFriendsWithCompletionHandler:^(NSArray *friends, NSError *error) {
13.                 if (error == nil)
15.                {
17.                     [self loadPlayerData:friends];
19.                }
21.                else
23.                {
25.                    ;// report an error to the user.
27.                }
29.            }];
31.             
33.        }
35.    }复制代码

复制代码

上面的friends得到的只是一个身份列表,里面存储的是NSString,想要转换成好友ID,必须调用- (void) loadPlayerData: (NSArray *) identifiers方法,该方法得到的array里面存储的才是GKPlayer对象.如下

1.   /*
3.      Whether you received player identifiers by loading the identifiers for the local player’s
5.     friends, or from another Game Center class, you must retrieve the details about that player
7.     from Game Center.
9.      */
11.     - (void) loadPlayerData: (NSArray *) identifiers
13.      {
15.        [GKPlayer loadPlayersForIdentifiers:identifiers withCompletionHandler:^(NSArray *players, NSError *error) {
17.            if (error != nil)
19.            {
21.                 // Handle the error.
23.           }
25.            if (players != nil)
27.            {
29.               NSLog(@"得到好友的alias成功");
31.                GKPlayer *friend1 = [players objectAtIndex:0];
33.               NSLog(@"friedns---alias---%@",friend1.alias);
35.               NSLog(@"friedns---isFriend---%d",friend1.isFriend);
37.               NSLog(@"friedns---playerID---%@",friend1.playerID);
39.            }
41.        }];
43.    }复制代码

复制代码

至此,leaderboard功能介绍完毕

6.对Achievement进行操作
  这一部分内容比较多,而且有的地方有点重复的感觉.
6.1汇报一个成就的进度
  对于一个玩家可见的成就,你需要尽可能的报告给玩家解锁的进度;对于一个一部完成的成就,则不需要,当玩家的进度达到100%的时候,会自动解锁该成就.

1. - (void) reportAchievementIdentifier: (NSString*) identifier percentComplete: (float) percent
3.     {
5.          GKAchievement *achievement = [[[GKAchievement alloc] initWithIdentifier: identifier] autorelease];
7.         if (achievement)
9.        {
11.             achievement.percentComplete = percent;
13.              [achievement reportAchievementWithCompletionHandler:^(NSError *error)
15.               {
17.                   if (error != nil)
19.                 {
21.                    //The proper way for your application to handle network errors is retain
23.                     //the achievement object (possibly adding it to an array). Then, periodically
25.                    //attempt to report the progress until it is successfully reported.
27.                    //The GKAchievement class supports the NSCoding protocol to allow your
29.                     //application to archive an achie
31.                     NSLog(@"报告成就进度失败 ,错误信息为: %@",error);
33.               }else {
35.                      //对用户提示,已经完成XX%进度
37.                     NSLog(@"报告成就进度---->成功!");
39.                     NSLog(@"    completed:%d",achievement.completed);
41.                    NSLog(@"    hidden:%d",achievement.hidden);
43.                     NSLog(@"    lastReportedDate:%@",achievement.lastReportedDate);
45.                    NSLog(@"    percentComplete:%f",achievement.percentComplete);
47.                     NSLog(@"    identifier:%@",achievement.identifier);
49.                }
51.              }];
53.        }
55.    }复制代码

复制代码

其中该函数的参数中identifier是你成就的ID, percent是该成就完成的百分比

6.2读取一个成就
方法一:得到所有的成就

1. - (void) loadAchievements
3.      {
5.        NSMutableDictionary *achievementDictionary = [[NSMutableDictionary alloc] init];
7.          [GKAchievement loadAchievementsWithCompletionHandler:^(NSArray *achievements,NSError *error)
9.          {
11.              if (error == nil) {
13.                 NSArray *tempArray = [NSArray arrayWithArray:achievements];
15.                  for (GKAchievement *tempAchievement in tempArray) {
17.                      [achievementDictionary setObject:tempAchievement forKey:tempAchievement.identifier];
19.                     NSLog(@"    completed:%d",tempAchievement.completed);
21.                     NSLog(@"    hidden:%d",tempAchievement.hidden);
23.                    NSLog(@"    lastReportedDate:%@",tempAchievement.lastReportedDate);
25.                     NSLog(@"    percentComplete:%f",tempAchievement.percentComplete);
27.                     NSLog(@"    identifier:%@",tempAchievement.identifier);
29.                 }
31.             }
33.          }];
35.    }复制代码

复制代码

函数中NSArray返回的是你的所有成就ID.

方法二:根据ID获取成就

1. - (GKAchievement*) getAchievementForIdentifier: (NSString*) identifier
3.      {
5.         NSMutableDictionary *achievementDictionary = [[NSMutableDictionary alloc] init];
7.        GKAchievement *achievement = [achievementDictionary objectForKey:identifier];
9.         if (achievement == nil)
11.         {
13.              achievement = [[[GKAchievement alloc] initWithIdentifier:identifier] autorelease];
15.             [achievementDictionary setObject:achievement forKey:achievement.identifier];
17.         }
19.       return [[achievement retain] autorelease];
21.    }复制代码

复制代码

6.3获取成就描述和图片
在自定义界面中,玩家需要一个成就描述,以及该成就的图片,Game Center提供了该功能.当然,你也可以自己在程序中完成,毕竟玩家不可能时刻处于在线状态.

1.   - (NSArray*)retrieveAchievmentMetadata
3.     {
5.         //读取成就的描述
7.         [GKAchievementDescription loadAchievementDescriptionsWithCompletionHandler:
9.           ^(NSArray *descriptions, NSError *error) {
11.             if (error != nil)
13.              {
15.                   // process the errors
17.                   NSLog(@"读取成就说明出错");
19.             }
21.            if (descriptions != nil)
23.              {
25.                 // use the achievement descriptions.
27.                 for (GKAchievementDescription *achDescription in descriptions) {
29.                      NSLog(@"1..identifier..%@",achDescription.identifier);
31.                      NSLog(@"2..achievedDescription..%@",achDescription.achievedDescription);
33.                     NSLog(@"3..title..%@",achDescription.title);
35.                      NSLog(@"4..unachievedDescription..%@",achDescription.unachievedDescription);
37.                    NSLog(@"5............%@",achDescription.image);
39.                    
41.                      //获取成就图片,如果成就未解锁,返回一个大文号
43.                     /*
45.                     [achDescription loadImageWithCompletionHandler:^(UIImage *image, NSError *error) {
47.                         if (error == nil)
49.                         {
51.                             // use the loaded image. The image property is also populated with the same image.
53.                             NSLog(@"成功取得成就的图片");
55.                              UIImage *aImage = image;
57.                            UIImageView *aView = [[UIImageView alloc] initWithImage:aImage];
59.                             aView.frame = CGRectMake(50, 50, 200, 200);
61.                             aView.backgroundColor = [UIColor clearColor];
63.                             [[[CCDirector sharedDirector] openGLView] addSubview:aView];
65.                          }else {
67.                            NSLog(@"获得成就图片失败");
69.                         }
71.                    }];
73.                       */
75.                 }
77.             }
79.         }];
81.       return nil;
83.    }复制代码

复制代码

    如果你不主动使用注释中的方法,那么你得到的description中不会有图片,这样可以减少网络的使用,尽量少下载东西.当使用注释中的代码时,如果成就已经解锁,则返回该成就的图标,如果没有解锁,则返回一个大问号,至于未解锁图标是否可以自定义,我找寻的结果好像是不可以.GameCenter  成就提示更新： GameCenter中成就提示需要开发者自定义，即使官方Demo的例子程序中也没有给与提示框（横幅样式）通知用户的官方代码，所以这里Himi介绍如何模仿官方的成就提示：   1. iOS5以及更高SDK中，apple已经提供官方的成就提示：方法很简单，代码如下：

1. - (void)sendAchievement:(GKAchievement *)achievement {
5. achievement.percentComplete = 100.0;   //Indicates the achievement is done
7. achievement.showsCompletionBanner = YES;    //Indicate that a banner should be shown
9. [achievement reportAchievementWithCompletionHandler:
11. ^(NSError *error) {
13. dispatch_async(dispatch_get_main_queue(), ^(void)
15. {
17. if (error == NULL) {
19. NSLog(@"Successfully sent archievement!");
21. } else {
23. NSLog(@"Achievement failed to send... will try again
25. later.  Reason: %@", error.localizedDescription);
27. }
29. });
31. }];
33. }复制代码

复制代码

    将“showsCompletionBanner”属性设置成YES，提交给苹果。新iOS属性“showsCompletionBanner”，其默认设置是NO，但若将其调整成YES，屏幕就呈现包含成就标题和描述的漂亮横幅；
2.如果低于5.0的SDK设备中是没有 “showsCompletionBanner”属性的，所以需要我们自定义提示样式，当然这里Himi也分享一下如何模仿官方横幅提示样式的方法和代码：      首先，我借鉴Type One Error所展示的优秀代码，从https://github.com/typeoneerror/GKAchievementNotification中抓取一些代码植入自己的项目。我们将采用GKAchievementNotification和GKAchievementHandler类，同时进行相应更新和修改。首先，若你在游戏中运用ARC，快速扫描代码，移除那些发行、保留和自动发行代码属性。若你不想进行扫描，试着将文件放入项目及修复不符编译程序的内容，然后再创建内容。Type One Error类将展示类似于iOS 5所呈现的通知内容，但代码需获悉成就标题和描述是什么。为实现这点，你需要嵌入“showsCompletionBanner”目标。GKAchievementDescription目标的优点是它们已根据用户语言设定进行本土化，因此采用此方式不存在任何本土化问题。其弊端在于你无法只加载一个成就描述，你需要加载所有内容。我认为进行此操作的最佳时间是用户已在应用上认证Game Center，此时你需要通过异步调用获得这些消息。值得欣慰的是，苹果在此设有API调用，我将此放置在用户认证访问的CompletionHandler中。若你采用Ray Wenderlich网站的代码，那么你就既能够运用此方法，又拥有新方法。将NSMutableDictionary * self.achievementsDescDictionary添加至所有处理游戏Game Center代码的类（游戏邦注：它会在随后的体验中存储成就数据）。

1. - (void)authenticateLocalUser {
5. if (!gameCenterAvailable) return;
9. NSLog(@”Authenticating local user…”);
11. if ([GKLocalPlayer localPlayer].authenticated == NO) {
13. [[GKLocalPlayer localPlayer]
15. authenticateWithCompletionHandler:^(NSError *error) {
17. if([GKLocalPlayer localPlayer].isAuthenticated){
19. [self retrieveAchievmentMetadata];         //Here is the new code
21. }
23. }];
25. }
27. }
31. //Here is the new method.
33. - (void) retrieveAchievmentMetadata
35. {
37. self.achievementsDescDictionary = [[NSMutableDictionary alloc] initWithCapacity:2];
41. [GKAchievementDescription loadAchievementDescriptionsWithCompletionHandler:
43. ^(NSArray *descriptions, NSError *error) {
45. if (error != nil) {
47. NSLog(@"Error %@", error);
51. } else {
53. if (descriptions != nil){
55. for (GKAchievementDescription* a in descriptions) {
57. [achievementsDescDictionary setObject: a forKey: a.identifier];
59. }
61. }
63. }
65. }];
67. }
71. “retrieveAchievmentMetadata”方法会初始化所有信息库，然后调用游戏所有成就描述，进行循环，将它们添加至信息库。这属于异步调用，所以不应减缓游戏或项目的启动。
75. 现在我们握有各成就的标题和描述，因此能够修改原始代码创造iOS 4/5的善意通知，其将通过Type One Error代码连续展示所有成就。
79. - (void)reportAchievement:(NSString *)identifier
81. percentComplete:(double)percentComplete {
85. GKAchievement* achievement = [[GKAchievement alloc]
87. initWithIdentifier:identifier];
89. achievement.percentComplete = percentComplete;
93. if (percentComplete == 100.0) {
95. //Show banners manually
97. GKAchievementDescription *desc = [achievementsDescDictionary objectForKey:identifier]; //Update pull achievement description for dictionary
101. [[GKAchievementHandler defaultHandler] notifyAchievement:desc];  //Display to user
105. }
107. [achievementsToReport addObject:achievement];    //Queue up the achievement to be sent
109. [self save];
113. if (!gameCenterAvailable || !userAuthenticated) return;
115. [self sendAchievement:achievement];   //Try to send achievement
117. }
121. - (void)sendAchievement:(GKAchievement *)achievement {
123. [achievement reportAchievementWithCompletionHandler:
125. ^(NSError *error) {
127. dispatch_async(dispatch_get_main_queue(), ^(void)
129. {
131. if (error == NULL) {
133. NSLog(@"Successfully sent archievement!");
135. [achievementsToReport removeObject:achievement];   //Remove Achievement from queue.
137. } else {
139. NSLog(@”Achievement failed to send… will try again
141. later.  Reason: %@”, error.localizedDescription);
143. }
145. });
147. }];
149. }复制代码

复制代码

    如果你想让成就中显示为你在itunes connect中设置成就的自定义图片，首先将通知部分代码修改成如下代码：

1. if (percentComplete == 100.0) {
3. //Show banners manually
5. GKAchievementDescription *desc = [achievementsDescDictionary objectForKey:identifier];
9. [desc loadImageWithCompletionHandler:^(UIImage *image, NSError *error) {
11. if (error == nil)
13. {
15. [[GKAchievementHandler defaultHandler] setImage:desc.image];   //If image found, updates the image to the achievement image.
17. }
19. [[GKAchievementHandler defaultHandler] notifyAchievement:desc];
21. }];
25. }复制代码

复制代码

    使用以上方式默认为横屏显示成就通知，如果想换成竖屏提示，那么这里Himi给出参考代码：在“GKAchievementHandler”类中找到“notifyAchievement”，更新为：

1. - (void)notifyAchievement:(GKAchievementDescription *)achievement
3. {
7. GKAchievementNotification *notification = [[GKAchievementNotification alloc] initWithAchievementDescription:achievement];
9. notification.frame = kGKAchievementFrameStart;
11. notification.handlerDelegate = self;
15. //Adjusting rotation.
19. if ([[UIApplication sharedApplication] statusBarOrientation] == UIInterfaceOrientationLandscapeLeft) {
21. notification.transform = CGAffineTransformRotate(notification.transform, degreesToRadian(-90));
23. } else {
25. notification.transform = CGAffineTransformRotate(notification.transform, degreesToRadian(90));
27. }
31. [_queue addObject:notification];
33. if ([_queue count] == 1)
35. {
37. [self displayNotification:notification];
39. }
41. }复制代码

复制代码