Загрузка информации о списках лидеров игры (iOS 6)

Перечисление 4-1 показывает предпочтительный механизм для загрузки информации о доступных списках лидеров. Это возвращает массив объектов списка лидеров, один для каждого списка лидеров, определенного для Вашей игры на Игровом Центре.

Перечисление 4-1  , Получающее информацию о доступных списках лидеров

- (void) loadLeaderboardInfo

{

    [GKLeaderboard loadLeaderboardsWithCompletionHandler:^(NSArray *leaderboards, NSError *error) {

        self.leaderboards = leaderboards;

     }];

}

Таблица 4-4 перечисляет свойства что Вы обычно доступ на объекте списка лидеров.

Создание отчетов об очках к игровому центру

Ваша игра передает очки в Игровой Центр путем создания массива GKScore объекты, сообщаете ли Вы о единственном счете или многократных очках. Объект счета имеет свойства для проигрывателя, заработавшего счет, дата и время, которая счет был заработан, идентификатор для списка лидеров, счету нужно сообщить, и заработанный фактический счет. Вы выделяете и инициализируете новый объект счета для каждого счета, конфигурируете их свойства, и затем вызываете reportScores:withCompletionHandler: метод, чтобы отправить данные Игровому Центру.

Перечисление 4-2 показывает, как использовать массив GKScore объекты сообщить о счете Игровому Центру.

Перечисление 4-2  Сообщая о счете Игровому Центру (iOS 7)

- (void) reportScore: (int64_t) score forLeaderboardID: (NSString*) identifier

{

    GKScore *scoreReporter = [[GKScore alloc] initWithLeaderboardIdentifier: identifier];

    scoreReporter.value = score;

    scoreReporter.context = 0;

    NSArray *scores = @[scoreReporter];

    [GKScore reportScores:scores withCompletionHandler:^(NSError *error) {

    //Do something interesting here.

    }];

}

Объект счета инициализируется со списком лидеров ID для списка лидеров, которому это сообщает о своем счете, и затем метод устанавливает свойство значения в счет заработанный проигрыватель. ID списка лидеров должен быть идентификатором для списка лидеров, который Вы сконфигурировали в Подключении iTunes. Проигрыватель, кто заработал счет и время счет, был заработан, установлены автоматически, когда создавался объект счета. Об очках всегда сообщают для местного игрока.

Ваша игра должна создать объект счета и сообщить о счете Центру Гэйма сразу после того, как будет заработан счет. Это устанавливает дату и время точно и гарантирует, что о счете сообщают правильно. Если по некоторым причинам о счете нельзя было бы сообщить из-за сетевой ошибки, Гэйм Кит автоматически снова посылает данные, когда сеть становится доступной.

- (void) reportScore: (int64_t) score forLeaderboardID: (NSString*) category

{

    GKScore *scoreReporter = [[GKScore alloc] initWithCategory:category];

    scoreReporter.value = score;

    scoreReporter.context = 0;

    [scoreReporter reportScoreWithCompletionHandler:^(NSError *error) {

// Do something interesting here.

    }];

}

Работа со списком лидеров по умолчанию (iOS 7)

Список лидеров по умолчанию установлен при создании списков лидеров в Подключении iTunes. Однако список лидеров по умолчанию является установкой на проигрыватель также; поскольку проигрыватель играет в Вашу игру, можно обновить список лидеров по умолчанию, показанный тому проигрывателю.

Если необходимо знать список лидеров по умолчанию для местного игрока, Вы получаете его с помощью кода, подобного этому в Перечислении 4-4.

Перечисление 4-4  , Загружающее список лидеров по умолчанию для местного игрока (iOS 7)

[[GKLocalPlayer localPlayer] loadDefaultLeaderboardIdentifierWithCompletionHandler:

(void(^)(NSString *leaderboardIdentifier, NSError *error)) {

//Use the leaderboard identifier.

}]

Наиболее распространенное время для обновления списка лидеров по умолчанию - когда Вы сообщаете о счете, и Гэйм Кит обеспечивает удобный способ установить список лидеров по умолчанию, поскольку Вы сообщаете о счете. Создайте объект счета, и затем установите shouldSetDefaultLeaderboard свойство к YES. Когда о счете сообщают, категория объекта счета становится новым списком лидеров по умолчанию ID.

Перечисление 4-5  , Обновляющее список лидеров по умолчанию при создании отчетов о счете (iOS 7)

    GKScore *scoreReporter = [[GKScore alloc] initWithLeaderboardIdentifier:identifier];

    scoreReporter.shouldSetDefaultLeaderboard = YES

...

Однако можно также использовать GKLocalPlayer возразите для обновления списка лидеров по умолчанию непосредственно.

Перечисление 4-6  , Обновляющее список лидеров по умолчанию непосредственно

[[GKLocalPlayer localPlayer] setDefaultLeaderboardIdentifier: newLeaderboard completionHandler: (^)(NSError *error) {

// Log the error.

}

Работа со списком лидеров по умолчанию (iOS 6)

При предназначении для устройств рабочий iOS 6 используйте код, подобный этому в Перечислении 4-7 для загрузки списка лидеров по умолчанию. Используйте идентификатор категории при идентификации списка лидеров по умолчанию.

Перечисление 4-7  , Загружающее список лидеров по умолчанию для местного игрока (iOS 6)

[[GKLocalPlayer localPlayer] loadDefaultLeaderboardCategoryIDWithCompletionHandler:

((^)(NSString *categoryID, NSError *error)) {

// Use the category ID.

}]

Изменение списка лидеров в iOS 6 выполняется путем изменения идентификатора категории для списка лидеров. Перечисление 4-8 обеспечивает пример того, как сделать это использование setDefaultLeaderboardCategoryID:completionHandler: метод.

Перечисление 4-8  , Обновляющее список лидеров по умолчанию непосредственно (iOS 6)

[[GKLocalPlayer localPlayer] setDefaultLeaderboardCategoryID: newCategory completionHandler: (^)(NSError *error) {

// Log the error.

}

Отображение стандартного списка лидеров (iOS 6)

В дополнение к передающим очкам к Игровому Центру необходимо также позволить проигрывателям просматривать очки в игре. Самый простой способ сделать это с a GKGameCenterViewController объект. Можно скорректировать поведение контроллера представления Game Center так начальное содержание, которое оно выводит на экран, страница списка лидеров. Перечисление 4-9 показывает, как выполнить это. Метод инстанцирует нового контроллера представления и устанавливает gameCenterDelegate свойство для указания на представление просматривает контроллер. Это тогда конфигурирует другие свойства для показа страницы списка лидеров, выводя на экран только очки, заработанные в прошлый день. Контроллер представления тогда представлен. В OS X Вы используете GKDialogController класс для отображения контроллера представления, как описано в Отображении Игровых Элементов пользовательского интерфейса Центра.

Перечисление 4-9  , Выводящее на экран страницу списка лидеров Игрового пользовательского интерфейса Центра

- (void) showLeaderboard: (NSString*) leaderboardID

{

    GKGameCenterViewController *gameCenterController = [[GKGameCenterViewController alloc] init];

    if (gameCenterController != nil)

    {

       gameCenterController.gameCenterDelegate = self;

       gameCenterController.viewState = GKGameCenterViewControllerStateLeaderboards;

       gameCenterController.leaderboardTimeScope = GKLeaderboardTimeScopeToday;

       gameCenterController.leaderboardCategory = leaderboardID;

       [self presentViewController: gameCenterController animated: YES completion:nil];

    }

}

Когда проигрыватель заканчивает смотреть на список лидеров, делегата вызывают. Перечисление 4-10 показывает типичную реализацию, просто отклоняющую представленный контроллер представления.

Перечисление 4-10  , Отвечающее, когда проигрыватель отклоняет Игровое содержание Центра

- (void)gameCenterViewControllerDidFinish:(GKGameCenterViewController *)gameCenterViewController

{

    [self dismissViewControllerAnimated:YES completion:nil];

}

Получение данных счета

Когда Вы хотите получить данные счета от Игрового Центра, существуют времена. Когда Вы хотите создать пользовательский пользовательский интерфейс списка лидеров, наиболее распространенная причина загрузить данные счета состоит в том. Ваша игра использует a GKLeaderboard объект получить данные счета. В этом случае объект списка лидеров представляет запрос на данных, хранивших на Игровом Центре. Вы устанавливаете свойства на GKLeaderboard возразите для фильтрации, какие очки возвращаются к игре, затем говорят объекту загрузить очки. Таблица 4-5 перечисляет свойства, которые можно установить.

Получение подмножества данных списка лидеров, хранивших на Игровом Центре, имеет следующие шаги:

1. Запустите с набора всех очков, сохраненных в списке лидеров.

2. Отбросьте любые очки, не соответствующие playerScope, timeScope и identifier свойства.

   • Используйте category свойство при поддержке игр, разработанных для iOS 6 и ранее.

3. Сохраните только лучший остающийся счет к каждому проигрывателю.

4. Сортируйте список очков от лучше всего до худшего.

5. Возвратите подмножество очков, которые требуют range свойство.

Рисунок 4-1 показывает пример одного возможного поиска. Код, выполняющий этот поиск, предоставлен позже в Перечислении 4-11. В этом примере, очки больше чем старый день проигнорированы. Затем от остающегося набора очков мы видим, что у Боба есть два очков, поэтому только его лучший счет сохранен. Наконец, очки сортированы и оценены. Выбранный диапазон тогда возвращается к игре.

Если Вы обеспечиваете категорию, соответствующую объединенный список лидеров, все очки в единственных списках лидеров объединены вместе прежде, чем отфильтровать и сортировать, происходит. Рисунок 4-2 показывает те же очки как в более раннем примере, но теперь Вы видите, что очки фактически сохранены в двух различных списках лидеров, составляющих объединенный список лидеров.

Перечисление 4-11 показывает запрос данных списка лидеров в качестве примера. Метод для этого запроса инициализирует новый объект списка лидеров и конфигурирует playerScope, timeScope, и range свойства для захвата лучших десяти очков, заработанных сегодня.

Перечисление 4-11  , Получающее лучшие десять очков

- (void) retrieveTopTenScores

{

    GKLeaderboard *leaderboardRequest = [[GKLeaderboard alloc] init];

    if (leaderboardRequest != nil)

    {

        leaderboardRequest.playerScope = GKLeaderboardPlayerScopeGlobal;

        leaderboardRequest.timeScope = GKLeaderboardTimeScopeToday;

        leaderboardRequest.identifier = @"Combined.LandMaps"

        leaderboardRequest.range = NSMakeRange(1,10);

        [leaderboardRequest loadScoresWithCompletionHandler: ^(NSArray *scores, NSError *error) {

            if (error != nil)

            {

                // Handle the error.

            }

            if (scores != nil)

            {

                // Process the score information.

            }

            }];

    }

}

Ваша игра может создать запрос списка лидеров, получающий музыку к определенному списку проигрывателей, которыми Вы интересуетесь. Перечисление 4-12 обеспечивает массив идентификаторов проигрывателя к запросу. Когда Вы обеспечиваете список проигрывателей, playerScope свойство проигнорировано.

Перечисление 4-12  , Получающее главную музыку к проигрывателям в соответствии

- (void) receiveMatchBestScores: (GKMatch*) match

{

    GKLeaderboard *leaderboardRequest = [[GKLeaderboard alloc] initWithPlayerIDs: match.playerIDs];

        leaderboardRequest.timeScope = GKLeaderboardTimeScopeAllTime;

        leaderboardRequest.identifier = @"Combined.LandMaps"

        leaderboardRequest.range = NSMakeRange(1,10);

    if (query != nil)

    {

        [query loadScoresWithCompletionHandler: ^(NSArray *scores, NSError *error) {

            if (error != nil)

            {

                // Handle the error.

            }

            if (scores != nil)

            {

                // Process the score information.

            }

        }];

    }

}

В любом случае, возвращенном GKScore объекты предоставляют данные, Ваша игра должна создать настроенный пользовательский интерфейс. Ваша игра может использовать объект счета playerID загрузить псевдоним проигрывателя, как описано в Получении информации О Проигрывателях. formattedValue свойство предоставляет строке значение счета, отформатированное согласно параметрам, которые Вы обеспечили в Подключении iTunes.

Для поддержания оптимального пользовательского опыта только запросите список лидеров для данных, которые игра должна использовать или вывести на экран. Например, не пытайтесь получить все очки, сохраненные в списке лидеров сразу. Вместо этого захватите меньшие части списка лидеров и обновите Ваши представления по мере необходимости.

Расширение списков лидеров Используя контексты счета

Несмотря на то, что система счета и форматирования позволяет Вам создавать интересные списки лидеров, можно хотеть расширить систему списка лидеров для включения другой информации, определенной для игры. Вы делаете этот счет использования контексты. A GKScore объект имеет a context свойство, содержащее 64-разрядное целое число. Значение, сохраненное в этом свойстве, сохранено вместе со счетом. Игровой Центр не использует это значение вообще, и при этом это не влияет на форматирование счета. Ваша игра свободна использовать это целое число, чтобы хранить безотносительно информации, которую Вы хотите.

Вот несколько возможностей:

• Можно использовать context свойство для хранения флагов, обеспечивающих дополнительное содержание. Например, в мчащейся игре, используйте флаги для хранения, с каким автомобилем лицо завершило трассу. Затем в Вашем собственном пользовательском интерфейсе списка лидеров Вы могли вывести на экран надлежащее автомобильное изображение рядом с каждым счетом.

• Запишите действия пользователя и другие данные в к файлу. Вы тогда разрабатываете свой игровой механизм, чтобы быть в состоянии воспроизвести содержание того файла. Вы храните файл на своем собственном сервере и используете поле контекста в качестве индекса для ссылки на файл. Ваш пользовательский пользовательский интерфейс списка лидеров может тогда предложить возможность для наблюдения точно, как кто-то заработал счет.

• Можно реализовать воспроизведение непосредственно в геймплей. Например, в гипотетической мчащейся игре, Вы могли использовать файл воспроизведения проигрывателя для отображения фантомного автомобиля для текущего проигрывателя для гонок против.

Контрольный список для поддержки наборов списка лидеров

Добавить список лидеров устанавливает в Вашу игру, необходимо взять следующие шаги:

1. Перед добавлением достижений добавьте код для аутентификации местного игрока. Посмотрите Работу с Проигрывателями в Игровом Центре.

2. Гарантируйте, что Ваша игра содержит по крайней мере один список лидеров. Посмотрите Добавляющую Поддержку Списка лидеров Своей Игре для получения информации о создании списков лидеров.

3. Перейдите к Подключению iTunes и сконфигурируйте наборы списка лидеров для своей игры. Для каждого набора списка лидеров добавьте желаемые списки лидеров к набору списка лидеров. Посмотрите Работу с Наборами Списка лидеров в Подключении iTunes.

4. Добавьте код для загрузки наборов списка лидеров, связанных с текущей игрой. Посмотрите Загружающиеся Наборы Списка лидеров к Своей Игре.

5. Добавьте код для загрузки списков лидеров, содержавших в наборе списка лидеров. См. Загружающиеся Списки лидеров В Наборе.

Игра может иметь многократные наборы списка лидеров

Можно определить до 100 различных наборов списка лидеров для игры. Каждый набор списка лидеров может содержать до 100 списков лидеров максимум с 500 списков лидеров для Вашей игры. Вы выбираете, какие списки лидеров помещаются в каждом наборе списка лидеров. Игры, не использующие наборы списка лидеров, ограничиваются 100 списками лидеров.

Вот несколько возможных способов использовать различные наборы списка лидеров в Вашей игре:

• Игра с многократными механизмами выигрыша для каждого мира (счет, враги получили, собранные монеты) может объединить списки лидеров для каждого мира в набор списка лидеров.

• Игра с многократными механизмами выигрыша для каждого мира (счет, враги получили, собранные монеты) может объединить все списки лидеров для единственного механизма выигрыша в набор списка лидеров.

• Игра с многократными играемыми символами (воин, лучник) может объединить все списки лидеров для определенного символа в единственный набор списка лидеров.

Можно объединить число списков лидеров и наборов списка лидеров в любом формате, пока не превышены отдельные максимумы. Следующее является всеми допустимыми комбинациями:

• 5 наборов списка лидеров, каждый содержащий 100 списков лидеров

• 100 наборов списка лидеров, каждый содержащий 5 списков лидеров

• 3 набора списков лидеров, каждый содержащий 50 списков лидеров; 2 набора списка лидеров, каждый содержащий 100 списков лидеров; 1 набор списка лидеров, содержащий 1 список лидеров

Список лидеров Game Group и список лидеров установленные пределы

Число списков лидеров и наборов списка лидеров в группе ограничивается только числом приложений в группе. Каждая игра в группе может иметь много наборов списка лидеров, и списки лидеров, как утверждено в Игре Могут Иметь Многократные Наборы Списка лидеров. Например, если у группы есть три приложения в нем, то у группы может быть в общей сложности 300 наборов списка лидеров и списки лидеров 1500 года. Однако отдельное приложение все еще ограничивается 100 наборами списка лидеров и 500 списками лидеров.

Работа с Наборами Списка лидеров в Подключении iTunes

После того, как Вы решили использовать наборы списка лидеров в своей игре, необходимо сконфигурировать наборы списка лидеров в Подключении iTunes. В Подключении iTunes можно создать новые наборы списка лидеров и переместить списки лидеров в них. Для полных подробных данных об управлении списками лидеров Вашей игры и наборами списка лидеров см. Списки лидеров и Наборы Списка лидеров в Игровом Руководстве по конфигурированию Центра для Подключения iTunes.

Добавление поддержки набора списка лидеров игре

Для реализации поддержки набора списка лидеров в игре Вы используете классы, перечисленные в Таблице 4-6.

Прежде чем можно будет загрузить списки лидеров, содержавшие в наборе, необходимо загрузить сам набор. Получите список наборов списка лидеров для Вашей игры от Игрового Центра и выведите на экран их заголовки.

- (void) loadLeaderboardSetInfo

{

    [GKLeaderboardSet loadLeaderboardSetsWithCompletionHandler:^(NSArray *leaderboardSets, NSError *error) {

        self.leaderboardSets = leaderboardSets;

     }];

}

- (void) loadLeaderboardInfo

{

    [GKLeaderboard loadLeaderboardsWithCompletionHandler:^(NSArray *leaderboards, NSError *error) {

        self.leaderboards = leaderboards;

     }];

}