编写苹果游戏中心应用程序（翻译 1.11 编程获取排行榜信息）

 

1.11 编程获取排行榜信息

问题

    你想知道如何通过编程获取排行榜信息。

解决方案

    使用GKLeaderBoard类的实例方法loadScoresWithCompletionHandler:。

讨论

    编程获取排行榜信息的步骤：

    1. 验证本地玩家（条目1.5）。

    2. 实例化GKLeaderBoard的一个对象。

    3. 设置对象的分类为要读取的排行榜的“Reference ID”。

    4. 调用GKLeaderBoard的实例方法loadScoresWithCompletionHandler:，并传递一个返回void、接受两个参数的块对象。块对象的第一个参数是一个NSArray实例，它将包含指定排行榜的成绩。第二个参数是一个NSError类型，表示处理过程中是否有错。

    在特定情况下，游戏中心可能同时返回无效的成绩数组和错误。这意味着，虽然成功地取得了一些成绩，但也发生了错误；该成绩数组是不完整的。

    游戏中心中的每个排行榜都被封装到一个GKScore实例（条目1.10）。下面看个示例，演示从“Reference ID”（分类）为MGL1LB的排行榜获取成绩:

    GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];

    NSLog(@"Authenticating the local player...");
    [localPlayer authenticateWithCompletionHandler:^(NSError *error) {

        if (error == nil){

            NSLog(@"Successfully authenticated the local player.");
            GKLeaderboard *leaderboard =
                [[[GKLeaderboard alloc] init] autorelease];

            [leaderboard setCategory:@"MGL1LB"];
            NSLog(@"Loading the scores in leaderboard...");
            [leaderboard loadScoresWithCompletionHandler:
                ^(NSArray *scores, NSError *error) {

                    if (scores != nil){
                        for (GKScore *score in scores){
                            NSLog(@"%@", score);
                        }
                    }

                    if (error != nil){
                        NSLog(@"Error occurred = %@", error);
                    }

                 }];
            } else {
                NSLog(@"Failed to authenticate with error = %@", error);
        }

    }];

    在提交三个玩家（他们彼此为好友）的成绩（10,20,和35）（条目1.10）后，执行上面的代码，控制台将打印类似如下的信息：

    Authenticating the local player...
    Successfully authenticated the local player.
    Loading the scores in leaderboard...
    GKScore player=G:1428629742 rank=1 date=2011-03-27
        10:39:58 +0000 value=35 formattedValue=35points
    GKScore player=G:1428629254 rank=2 date=2011-03-27
        10:39:24 +0000 value=20 formattedValue=20points
    GKScore player=G:1428628142 rank=3 date=2011-03-27
        09:21:19 +0000 value=10 formattedValue=10points