Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы GameKit ссылка класса GKLeaderboardSet

Опции
Развертывание Target:

На этой странице
Язык:

GKLeaderboardSet

Наследование


Оператор импорта


Swift

import GameKit

Objective C

@import GameKit;

Доступность


Доступный в iOS 7.0 и позже.

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

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

Во время процесса разработки Вы создаете наборы списка лидеров для своей игры на Подключении iTunes.

Для получения информации о доступных списках лидеров для текущего набора используйте loadLeaderboardsWithCompletionHandler: метод класса.

Для получения информации о доступных наборах списка лидеров используйте loadLeaderboardSetsWithCompletionHandler: метод класса.

Для получения информации об изображении, связанном с набором списка лидеров, используйте loadImageWithCompletionHandler: метод класса.

  • Загрузите изображение, связанное с набором списка лидеров.

    Объявление

    Swift

    func loadImageWithCompletionHandler(_ completionHandler: ((UIImage!, NSError!) -> Void)!)

    Objective C

    - (void)loadImageWithCompletionHandler:(void (^)(UIImage *image, NSError *error))completionHandler

    Параметры

    completionHandler

    Блок, который вызывают, когда категории были получены от сервера.

    Блок получает следующие параметры:

    image

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

    error

    Если ошибка произошла, этот ошибочный объект описывает ошибку. Если работа завершилась успешно, значение nil.

    Обсуждение

    Когда этот метод вызывают, он создает новую фоновую задачу для обрабатывания запроса. Метод тогда возвращает управление Вашей игре. Позже, когда задача завершена, Гэйм Кит вызывает Ваш обработчик завершения. Обработчик завершения всегда вызывают на основном потоке.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.

  • Загрузите все наборы списка лидеров для текущей игры.

    Объявление

    Swift

    class func loadLeaderboardSetsWithCompletionHandler(_ completionHandler: (([AnyObject]!, NSError!) -> Void)!)

    Objective C

    + (void)loadLeaderboardSetsWithCompletionHandler:(void (^)(NSArray *leaderboardSets, NSError *error))completionHandler

    Параметры

    completionHandler

    Блок, который вызывают, когда категории были получены от сервера.

    Блок получает следующие параметры:

    leaderboardSets

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

    error

    Если ошибка произошла, этот ошибочный объект описывает ошибку. Если работа завершилась успешно, значение nil.

    Обсуждение

    Когда этот метод вызывают, он создает новую фоновую задачу для обрабатывания запроса. Метод тогда возвращает управление Вашей игре. Позже, когда задача завершена, Гэйм Кит вызывает Ваш обработчик завершения. Обработчик завершения всегда вызывают на основном потоке.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.

  • Загрузите все списки лидеров для текущего набора списка лидеров.

    Объявление

    Swift

    func loadLeaderboardsWithCompletionHandler(_ completionHandler: (([AnyObject]!, NSError!) -> Void)!)

    Objective C

    - (void)loadLeaderboardsWithCompletionHandler:(void (^)(NSArray *leaderboards, NSError *error))completionHandler

    Параметры

    completionHandler

    Блок, который вызывают, когда категории были получены от сервера.

    Блок получает следующие параметры:

    leaderboards

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

    error

    Если ошибка произошла, этот ошибочный объект описывает ошибку. Если работа завершилась успешно, значение nil.

    Обсуждение

    Когда этот метод вызывают, он создает новую фоновую задачу для обрабатывания запроса. Метод тогда возвращает управление Вашей игре. Позже, когда задача завершена, Гэйм Кит вызывает Ваш обработчик завершения. Обработчик завершения всегда вызывают на основном потоке.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.

  • title Свойство

    Локализованный заголовок для списка лидеров установлен. (только для чтения)

    Объявление

    Swift

    var title: String! { get }

    Objective C

    @property(readonly, copy, nonatomic) NSString *title

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.

  • identifier Свойство

    Идентификатор для списка лидеров установлен.

    Объявление

    Swift

    var identifier: String!

    Objective C

    @property(copy, nonatomic) NSString *identifier

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.

  • groupIdentifier Свойство

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

    Объявление

    Swift

    var groupIdentifier: String! { get }

    Objective C

    @property(nonatomic, readonly, retain) NSString *groupIdentifier

    Обсуждение

    Когда набор списка лидеров является частью игровой группы, это установлено. Это установлено когда loadLeaderboardSetsWithCompletionHandler: вызывается в списках лидеров той игрой поддержки группами.

    Оператор импорта

    Objective C

    @import GameKit;

    Swift

    import GameKit

    Доступность

    Доступный в iOS 7.0 и позже.