Строки идентификатора проигрывателя однозначно определяют проигрыватели

Каждая учетная запись проигрывателя однозначно определяется строкой идентификатора проигрывателя. Строка идентификатора создается, когда учетная запись проигрывателя сначала создается и никогда не изменяется, даже если изменяется другая информация в учетной записи. Таким образом идентификаторы проигрывателя являются единственным надежным способом отследить определенный проигрыватель. Поэтому Игровой API Набора использует идентификаторы проигрывателя везде, где должен быть идентифицирован определенный проигрыватель. Если Игровой Центр должен идентифицировать определенный проигрыватель в Вашей игре, Игровой Набор возвраты API что идентификатор проигрывателя. Ваша игра использует идентификатор проигрывателя для получения информации от Игрового Центра о том проигрывателе.

В дополнение к использованию идентификаторов проигрывателя в Ваших взаимодействиях с Игровым Центром Ваша игра должна также использовать идентификатор проигрывателя каждый раз, когда это хочет хранить данные локально об определенном проигрывателе. Например, если Ваша игра хранит данные для отслеживания прогресса проигрывателя (такой, поскольку на устройстве, на собственном сервере, или на iCloud), используйте идентификаторы проигрывателя для различения многократные проигрыватели, играющие на том же устройстве. Тот путь, если различный проигрыватель подписывается в устройство, можно сразу персонализировать опыт путем показа содержания, определенного для того проигрывателя.

Местный игрок является проигрывателем, регистрировался к устройству

При разработке игры Вы найдете, что Ваша игра часто знает о многократных проигрывателях одновременно. Например, при разработке игры с помощью многопользовательских сетей тогда у Вас есть информация — и идентификатор проигрывателя — для каждого проигрывателя в соответствии. Однако на любом определенном устройстве, один проигрыватель всегда имеет приоритет по другим проигрывателям. Местный игрок является проигрывателем, в настоящее время аутентифицирующимся для игры на том устройстве. На рисунке 3-1 два плеера подключаются в сетевом соответствии. На левом устройстве Боб является местным игроком, и Мэри является удаленным проигрывателем. На правильном устройстве Мэри является местным игроком, и Боб является удаленным проигрывателем.

Почти все классы в Гэйме Ките, отправляющие данные в или получающие информацию от Центра Гэйма, ожидают, что устройство будет иметь аутентифицируемого местного игрока. Работа, которую выполняют те классы, всегда от имени местного игрока. Например, если Ваша игра сообщает об очках списку лидеров, она может только сообщить о счете, заработанном местным игроком. Также, перед использованием любых функций Game Center Ваша игра должна сначала аутентифицировать это на устройстве существует местный игрок. Гэйм Кит возвращает ошибку Вашей игре, если она пытается выполнить задачи Гэйма Сентер-релэтеда, требующие аутентифицируемого проигрывателя, когда каждый не доступен на устройстве.

Объекты проигрывателя предоставляют подробную информацию о проигрывателях

Когда для Вашей игры нужны подробные данные для определенного проигрывателя, она получает те подробные данные путем создания запроса к Игровому Центру использованием идентификатора проигрывателя проигрывателя. Игровой Набор возвращает те подробные данные Вашей игре в a GKPlayer объект. Таблица 3-1 перечисляет некоторые более интересные свойства на объекте проигрывателя.

GKLocalPlayer класс является специальным подклассом GKPlayer класс, и включает дополнительные свойства, определенные для местного игрока:

• friends свойство заполняется со строками идентификатора для других проигрывателей на Игровом Центре, отмеченных как друзья местного игрока.

• underage свойство утверждает, является ли этот проигрыватель несовершеннолетним.

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

Аутентификация местного игрока на устройстве

Ваша игра должна начать аутентифицировать проигрыватель как можно раньше после запуска, даже перед представлением пользовательского интерфейса. Аутентификация является асинхронным процессом и не замедлит загрузку Вашего экрана заголовка. При ожидании, пока экран заголовка не представлен прежде, чем аутентифицировать пользователя, только увеличивает задержку, пока проигрыватель не может играть игру. Главная причина необходимо аутентифицировать проигрыватель как можно раньше, состоит в том так, чтобы iOS мог запустить игру в частности для обработки событий, которыми интересуется проигрыватель. Например, если Ваша игра поддерживает основанные на повороте соответствия, она могла бы быть запущена, потому что проигрыватель уже коснулся баннера уведомления. Таким образом необходимо аутентифицировать рано так, чтобы игра могла получить и обработать событие Game Center.

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

Если в настоящее время нет аутентифицируемого проигрывателя на устройстве, то диалог аутентификации должен быть выведен на экран так, чтобы проигрыватель мог регистрироваться с существующей учетной записью или создать новую Игровую учетную запись Центра. Это важно, потому что это означает, что поддержка аутентификации также означает прозрачно поддерживать создание учетной записи.

Фактический процесс отображения пользовательского интерфейса к проигрывателю зависит, на котором механизме Вы используете для аутентификации. Существует два способа, которыми можно аутентифицировать проигрыватель. Исходный механизм, сначала используемый в iOS 4.1 автоматически, выводит на экран пользовательский интерфейс к проигрывателю при необходимости, но это может произойти в необычное время во время последовательности запуска Вашей игры. Более новый механизм, сначала реализованный в iOS 6 и OS X v10.8.2, вручает Вашей игре контроллер представления для отображения во время выбора. Как правило, это означает, что Ваша игра может чисто приостановить свои собственные анимации и другие функции прежде, чем вывести на экран контроллер представления. Более новый механизм позволяет Вам создавать лучший пользовательский опыт для проигрывателя, и таким образом является предпочтительным способом реализовать аутентификацию.

- (void) authenticateLocalPlayer

{

    GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];

    localPlayer.authenticateHandler = ^(UIViewController *viewController, NSError *error){

         if (viewController != nil)

         {

             //showAuthenticationDialogWhenReasonable: is an example method name. Create your own method that displays an authentication view when appropriate for your app.

             [self showAuthenticationDialogWhenReasonable: viewController];

         }

         else if (localPlayer.isAuthenticated)

         {

             //authenticatedPlayer: is an example method name. Create your own method that is called after the loacal player is authenticated.

             [self authenticatedPlayer: localPlayer];

         }

         else

         {

             [self disableGameCenter];

         }

     };

}

- (void) authenticateLocalPlayer

{

    GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];

    [localPlayer authenticateWithCompletionHandler:^(NSError *error) {

         if (localPlayer.isAuthenticated)

         {

             // Player was successfully authenticated.

             // Perform additional tasks for the authenticated player.

         }

     }];

}

Получение друзей местного игрока

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

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

Перечисление 3-3 показывает, как Ваша игра загружает список идентификаторов проигрывателя для друзей местного игрока. Это тогда вызывает loadPlayerData: метод, определенный в Перечислении 3-5 для выборки подробных данных для тех проигрывателей. При использовании iOS 6.0 и ранее, изменитесь friendIDs свойство к friends.

Перечисление 3-3  , Получающее друзей местного игрока

- (void) retrieveFriends

{

   GKLocalPlayer *lp = [GKLocalPlayer localPlayer];

   if (lp.authenticated)

   {

      [lp loadFriendsWithCompletionHandler:^(NSArray *friendIDs, NSError *error) {

         if (friendIDs != nil)

         {

            [self loadPlayerData: friendIDs];

         }

      }];

   }

}

Перечисление 3-4  , Получающее (предыдущих) друзей местного игрока

- (void) retrieveFriends

{

   GKLocalPlayer *lp = [GKLocalPlayer localPlayer];

   if (lp.authenticated)

   {

      [lp loadFriendsWithCompletionHandler:^(NSArray *friends, NSError *error) {

         if (friends != nil)

         {

            [self loadPlayerData: friends];

         }

      }];

   }

}

Получение информации о проигрывателях

Независимо от которого класс Гэйма Кита возвратил идентификаторы проигрывателя Вашей игре, Вы получаете подробную информацию о тех проигрывателях таким же образом путем вызова loadPlayersForIdentifiers:withCompletionHandler: метод класса для GKPlayer класс. Перечисление 3-5 показывает скелетную реализацию. Этот метод Гэйма Кита берет два параметра. Первым является массив идентификаторов проигрывателя для проигрывателей, которыми Вы интересуетесь. Вторым является обработчик завершения, который вызовут после того, как Гэйм Кит получит данные от Центра Гэйма. Гэйм Кит загружает данные асинхронно в фоновом режиме и вызывает Ваш обработчик завершения после того, как завершится задача. Обработчик завершения получает массив GKPlayer объекты (один для каждого идентификатора), а также параметр ошибок.

Перечисление 3-5  , Получающее подробные данные проигрывателя

- (void) loadPlayerData: (NSArray *) identifiers

{

    [GKPlayer loadPlayersForIdentifiers:identifiers withCompletionHandler:^(NSArray *players, NSError *error) {

        if (error != nil)

        {

            // Handle the error.

        }

        if (players != nil)

        {

            // Process the array of GKPlayer objects.

        }

     }];

}

Если Гэйм Кит был неспособен загрузить информацию для всех проигрывателей, она обеспечивает ошибку для обработчика завершения. Когда это происходит, players параметр может обеспечить частичный массив для проигрывателей, о которых Гэйм Кит смог получить информацию. Поэтому Перечисление 3-5 тестирует состояние ошибки отдельно от обработки массива объектов проигрывателя.

Загрузка фотографии для проигрывателя

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

Перечисление 3-6 показывает типичную реализацию этого понятия, следующего за тем же образцом как другие классы Гэйма Кита. Это вызывает loadPhotoForSize:withCompletionHandler: метод на объекте проигрывателя, и затем ожидает обработчика завершения, который вызовут. Обратите внимание на то, что нет свойства на объекте проигрывателя, хранящем возвращенную фотографию. Необходимо записать собственный код для соединения фотографий проигрывателя с объектами проигрывателя.

Перечисление 3-6  , Загружающее фотографию проигрывателя

- (void) loadPlayerPhoto: (GKPlayer*) player

{

    [player loadPhotoForSize:GKPhotoSizeSmall withCompletionHandler:^(UIImage *photo, NSError *error) {

        if (photo != nil)

        {

            [self storePhoto: photo forPlayer: player];

        }

        if (error != nil)

        {

            // Handle the error if necessary.

        }

     }];

}

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

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

Перечисление 3-7 показывает один способ, которым Ваш контроллер представления может позволить проигрывателю отправлять запрос к другим проигрывателям. Для этого метода массив идентификаторов проигрывателя передается в в качестве параметра. Метод инстанцирует a GKFriendRequestComposeViewController объект, устанавливает своего делегата и добавляет, что список проигрывателей намеревался получить приглашение. Контроллер представления тогда представляет запрос на добавление в друзья и возвраты.

Перечисление 3-7  , Выводящее на экран запрос на добавление в друзья

- (void) inviteFriends: (NSArray*) identifiers

{

    GKFriendRequestComposeViewController *friendRequestViewController = [[GKFriendRequestComposeViewController alloc] init];

    friendRequestViewController.composeViewDelegate = self;

    if (identifiers)

    {

        [friendRequestViewController addRecipientsWithPlayerIDs: identifiers];

    }

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

    [friendRequestViewController release];

}

Когда проигрыватель отклоняет запрос на добавление в друзья, делегат friendRequestComposeViewControllerDidFinish: метод вызывают. Перечисление 3-8 показывает, как Ваш контроллер представления должен отклонить запрос.

Перечисление 3-8  , Отвечающее, когда проигрыватель отклоняет запрос на добавление в друзья

- (void)friendRequestComposeViewControllerDidFinish:(GKFriendRequestComposeViewController *)viewController

{

    [self dismissViewControllerAnimated:YES completion:nil];

}