编写苹果游戏中心应用程序（翻译 1.14 向游戏中心提交成就）

 

1.14 向游戏中心提交成就

问题

    你已准备好在游戏中使用成就。

解决方案

    使用GKAchievement类。

讨论

    提交成就的过程和提交成绩（条目1.10）相似，步骤是：

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

    2. 分配和初始化GKAchievement类型的对象。分配对象有两种方法：一是使用initWithIdentifier:方法；二是先简单地使用init方法，然后再使用setIdentifier:方法设置标识符。标识符是我们创建成就（条目1.13）时指定的“Achievement ID”。

    3. 使用对象的setPercentComplete:方法设置成就的完成度（0%－100%）。

    4. 调用reportAchievementWithCompletionHandler:方法，传递一个返回void、接受一个NSError类型参数的块对象。

    下面的示例代码提交ID为“MGL1HP1C”（条目1.13）的成就50%的完成度

    - (BOOL) reportAchievementWithID:(NSString *)paramAchievementID
                 percentageCompleted:(double)paramPercentageCompleted{

        BOOL result = NO;

        if ([paramAchievementID length] == 0){
            NSLog(@"Achievement ID cannot be empty.");
            return NO;
        }

        GKAchievement *achievement =
            [[[GKAchievement alloc] initWithIdentifier:paramAchievementID]
autorelease];

        NSLog(@"Setting percentage to %.02f", paramPercentageCompleted);
        [achievement setPercentComplete:paramPercentageCompleted];

        NSLog(@"Reporting the achievement...");
        [achievement reportAchievementWithCompletionHandler:^(NSError *error) {

            if (error == nil){
                NSLog(@"Successfully reported the achievement.");
            } else {
                NSLog(@"Failed to report the achievement. %@", error);
            }

        }];

        return result;

    }

    - (void) authenticateLocalPlayerAndReportAchievement{

        GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];

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

            if (error == nil){
                NSLog(@"Successfully authenticated the local player.");
                NSLog(@"Reporting achievement...");
                [self reportAchievementWithID:@"MGL1HP1C"
                          percentageCompleted:50.0f];
            } else {
                NSLog(@"Failed to authenticate the local player. %@", error);
            }

        }];
    }

    在调用authenticateLocalPlayerAndReportAchievement方法后，控制台输出类似如下的结果（除非有错误发生；在这种情况下，将输出错误信息）：

        Authenticating the local player...
        Successfully authenticated the local player.
        Reporting achievement...
        Setting percentage to 50.00
        Reporting the achievement...
        Successfully reported the achievement.

    在成就提交到游戏中心之后，如果成就没有被设置为隐藏，那么本地玩家就可以打开游戏中心应用程序查看它（当然，还有该玩家使用该程序所获得的所有其他成就），如图1-14所示。

图 1-14 iOS模拟器上的成就

    一旦玩家选择“Achievements”选项，他将看到程序提交给游戏中心的所有成就，以及每个成就的进度，如图1-15所示。

图 1-15 iOS模拟器上的成就进度

    在iTunes Connect中创建成就之后，可能需要延迟一小段时间，你才能提交该成就的进度。如果你得到的错误说成就不存在，但你确信它存在，请等待5-10分钟，然后重试。