Игровой центр налагает пределы на соответствие

Таблица 10-2 описывает два из важных пределов, которые необходимо рассмотреть при разработке игры. Эти пределы подвержены изменениям и могут оба быть запрошены во время выполнения.

Присоединение к новому соответствию

Когда проигрыватель присоединяется к соответствию, для проигрывателей начинается новый матч. Как с другими формами matchmaking, Ваша игра запускает процесс путем создания a GKMatchRequest объект, как описано в Создании Любого Вида Соответствия Запускается с Запроса Соответствия. Запрос соответствия не гарантирует, что новое соответствие будет создаваемым; это может также соответствовать проигрыватель в существующее соответствие, имеющее пустую позицию как текущий проигрыватель.

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

- (IBAction)joinChessMatch: (id) sender

{

    GKMatchRequest *request = [[GKMatchRequest alloc] init];

    request.minPlayers = 2;

    request.maxPlayers = 2;

    GKTurnBasedMatchmakerViewController *mmvc = [[GKTurnBasedMatchmakerViewController alloc] initWithMatchRequest:request];

    mmvc.turnBasedMatchmakerDelegate = self;

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

}

- (void)turnBasedMatchmakerViewControllerWasCancelled:(GKTurnBasedMatchmakerViewController *)viewController

{

    [self dismissViewControllerAnimated:YES completion:nil];

}

- (void)turnBasedMatchmakerViewController:(GKTurnBasedMatchmakerViewController *)viewController didFailWithError:(NSError *)error

{

    [self dismissViewControllerAnimated:YES completion:nil];

}

- (void)turnBasedMatchmakerViewController:(GKTurnBasedMatchmakerViewController *)viewController didFindMatch:(GKTurnBasedMatch *)match

{

    [self dismissViewControllerAnimated:YES completion:nil];

    [self performSegueWithIdentifier:@"GamePlayScene" sender:match];

}

- (void )prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender

{

    if ([segue.identifier isEqualToString:@"GamePlayScene"])

    {

        MyGamePlayViewController* gameVC = (MyGamePlayViewController*) segue.destinationViewController;

        gameVC.delegate = self;

        gameVC.match = (GKTurnBasedMatch*) sender;

    }

}

- (IBAction)findProgrammaticMatch: (id) sender

{

    GKMatchRequest *request = [[GKMatchRequest alloc] init];

    request.minPlayers = 4;

    request.maxPlayers = 16;

    [GKTurnBasedMatch findMatchForRequest: request withCompletionHandler:^(GKTurnBasedMatch *match, NSError *error)

    {

        if (match)

            [self performSegueWithIdentifier:@"GamePlayScene" sender:match];

    }];

}

Работа с существующими соответствиями

Если Вы выводите на экран стандарт matchmaking пользовательский интерфейс, то проигрыватель видит существующие соответствия также. Проигрыватель может выбрать существующее соответствие, уже происходящее, и выполнить другие общие задачи. Если проигрыватель выбирает существующее соответствие, turnBasedMatchmakerViewController:didFindMatch: метод вызывают, точно как его вызвали, когда создавалось новое соответствие. Обратите внимание на то, что в этом случае проигрыватель может не быть текущим проигрывателем.

Проигрыватель может принять решение уйти из соответствия из стандартного пользовательского интерфейса. Ваш делегат должен реализовать a turnBasedMatchmakerViewController:playerQuitForMatch: метод для обработки отставки проигрывателя. Ваша игра должна установить результат соответствия для проигрывателя отставки, и, если необходимо, выбрать другой проигрыватель для действия в соответствии. Для получения дополнительной информации посмотрите Установку Результата Соответствия Когда Участник Листы Соответствие.

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

Перечисление 10-6  , Получающее список соответствий местный игрок, участвует в

- (void) loadMatches

{

    [GKTurnBasedMatch loadMatchesWithCompletionHandler:^(NSArray *matches, NSError *error) {

      if (matches)

          {

// Use the match data to populate your user interface.

          }

     }];

}

Таблица 10-3 перечисляет наиболее распространенные действия, которые проигрыватель мог бы хотеть выполнить на соответствии.

Получение информации о соответствии

Когда проигрыватель решает просмотреть соответствие, Ваша игра читает свойства соответствия для определения текущего состояния соответствия. Таблица 10-4 перечисляет наиболее распространенные свойства, к которым необходимо получить доступ.

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

Работа с данными соответствия

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

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

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

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

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

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

• Закодируйте текущее состояние соответствия и ряда недавних действий проигрывателя: Это - гибридная стратегия, занимающая элементы из других двух стратегий. По существу данные соответствия, хранившие на Игровом Центре, состоят из недавнего снимка соответствия плюс другие данные, кодирующие недавние действия, так как был взят тот последний снимок. Когда данные, записывающие действия, становятся слишком большими, Ваша игра воспроизводит некоторые из тех перемещений для обновления снимка соответствия и затем удаляет те перемещения из его списка действий.

  С этой стратегией обычно необходимо определять, какие действия текущий проигрыватель видел (на основе того, когда они в последний раз приняли оборот). Когда Ваша игра сглаживает данные соответствия, она никогда не удаляет данных, не замеченных всеми участниками. Это позволяет всем участникам видеть перемещения, которые сделали их противники.

И вот некоторые другие общие руководящие принципы:

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

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

• Если Ваши игровые выполнения и в OS X и в iOS, используйте методы кодирования сетевых данных для предотвращения проблем порядка байтов.

- (void) loadAndDisplayMatchData

{

    [this.myMatch loadMatchDataWithCompletionhandler: ^(NSData *matchData, NSError *error) {

        if (matchData)

        {

// App-specific routine to decode the match data.

            this.gameData = [MyMatchDataClass initWithData: matchData];

            // Display the match.

        }

      }];

}

- (void) updateMatchData

{

// App-specific routine to encode the match data.

    NSData *updatedMatchData = [this.gameData encodeMatchData];

    [this.myMatch saveCurrentTurnWithMatchData: updatedMatchData completionHandler ^(NSError *error) {

        if (error)

        {

            // Handle the error.

        }

      }];

}

Усовершенствование состояния соответствия

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

Перечисление 10-9 показывает типичную структуру для этого кода, задерживая некоторые определенные шаги к специфичным для приложения подпрограммам, основывающимся на фактической структуре Вашей игры. Те методы представляют места, где необходимо обеспечить определенные реализации в игре. advanceTurn метод сначала устанавливает новое сообщение, затем кодирует текущие данные соответствия как прежде. Наконец, это вычисляет порядок, в котором участники должны действовать и вызывают endTurnWithNextParticipants:turnTimeout:matchData:completionHandler: метод для фактической передачи управления к тому списку проигрывателей.

Перечисление 10-9  , Совершенствующееся следующему участнику соответствия

- (void) advanceTurn

{

    NSData *updatedMatchData = [this.gameData encodeMatchData];

    NSArray *sortedPlayerOrder = [this.gameData encodePlayerOrder];

    this.MyMatch.message = [this.gameData matchAppropriateMessage];

    [this.myMatch endTurnWithNextParticipants: sortedPlayerOrder turnTimeOut: GKTurnTimeoutDefault

                  matchData: updatedMatchData completionHandler ^(NSError *error) {

        if (error)

        {

            // Handle the error.

        }

      }];

}

Установка результата соответствия, когда участник оставляет соответствие

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

Если местный игрок уходит из соответствия и является также текущим проигрывателем соответствия, Ваша игра должна вызвать объект соответствия participantQuitInTurnWithOutcome:nextParticipants:turnTimeout:matchData:completionHandler: метод. Этот метод подобен endTurnWithNextParticipants:turnTimeout:matchData:completionHandler: метод в этом это дает контроль другому участнику. Из-за этого Вы обязаны обновлять данные соответствия и обеспечивать участвующий список. Однако Ваша игра также обеспечивает результат соответствия для проигрывателя, просто вышедшего из соответствия — по существу, численное значение, указывающее, почему тот проигрыватель оставил соответствие. Участвующий объект для того проигрывателя обновляется для включения этого нового состояния соответствия. Как только участник вышел из соответствия, Ваша игра может не сделать тот проигрыватель текущим проигрывателем.

Игровой Набор обеспечивает некоторые стандартные значения, которые можно использовать для установки результата соответствия. Посмотрите Установку Результата Соответствия.

Например, на рисунке 10-4, Боб был просто устранен из соответствия. Игра принимает решение установить результат GKTurnBasedMatchOutcomeFourth и сделайте Мэри новым текущим проигрывателем. Боб может все еще просмотреть соответствие, но может не принять меры.

Иногда проигрыватель может оставить игру, когда они не текущий проигрыватель. Для обработки этого игра вызывает объект соответствия participantQuitOutOfTurnWithOutcome:withCompletionHandler: метод. Вы обеспечиваете результат соответствия, но не предоставляете новые данные соответствия или участвующий список.

Заканчивание матча

В конечном счете Ваша игровая логика собирается решить, что соответствие закончено. У всех участников соответствия должен быть допустимый результат соответствия прежде, чем закончить матч. Ваша игра вызывает объект соответствия endMatchInTurnWithMatchData:completionHandler: метод для формального заканчивания матча. Этот метод подобен другим методам, обновляющим состояние соответствия, но в этом случае Вы не обеспечиваете список участников, потому что никакие дальнейшие действия не позволяются в этом соответствии. Вы действительно обновляете сохраненные данные соответствия, чтобы описать, как закончился матч. Проигрыватели могут все еще выбрать это соответствие из matchmaking пользовательского интерфейса; Ваша игра должна вывести на экран окончание соответствия, но не позволить проигрывателю принимать меры.

Ответ на уведомления соответствия

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

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

- (void) installTurnBasedEventHandler

{

    [GKTurnBasedEventHandler sharedTurnBasedEventHandler].delegate = self;

}

Для ответа на события обработчик событий реализует методы, определенные GKTurnBasedEventHandlerDelegate протокол. Таблица 10-6 перечисляет события. События, полученные через уведомление нажатия, запускают Вашу игру или приносят Вашу игру к переднему плану (если необходимый), и тогда поставлены игре. Приоритетные события поставлены, только если Ваша игра работала на переднем плане, когда было получено событие.

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

По умолчанию, когда Ваша игра получает уведомление, значок добавляется к игровому значку. Добавить GKGameCenterBadgingDisabled к Вашему Info.plist изменить это поведение. Посмотрите Ключи Какао для подробных данных.

Анатомия Exchange

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

Используя обмены, можно разработать игру так, чтобы проигрыватели кроме текущего проигрывателя могли принять меры во время поворота. Обмен является взаимодействием между обменным инициатором и одним или более обменными получателями. Следующий поток операций используется для обмена:

• Инициатор отправляет обменный запрос получателю.

• Получатели уведомляются, что они получили обменный запрос.

• Получатель действует на обменный запрос и передает их действие обратно инициатору.

• Инициатор уведомляется относительно завершенного обмена.

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

Отправление запроса Exchange

В зависимости от того, как Вы разрабатываете свою игру, любой проигрыватель может подать обменную заявку, являются ли они текущим проигрывателем или нет. Например, во время очереди Мэри, Фред решает, что хочет торговать картами с Келли. Фред выбирает карты, которыми он хочет торговать Келли и что он хочет в ответ. Он тогда отправляет обменный запрос Келли. После того, как запрос отправлен, обновление отправляется Мэри так, чтобы могло быть обновлено соответствие. Посмотрите рисунок 10-5.

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

• Отправитель выбирает, кого отправить обменный запрос к.

• Природа запроса должна быть определена. Проигрыватель просит торговать картами, обращающимися за помощью в атаке другого проигрывателя или чего-то еще?

• Количество времени получатели должны реагировать на обменный запрос, должно быть установлено. Можно позволить отправителю выбирать это или устанавливать предел трудного времени.

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

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

- (void) exchangeRequest (GKTurnBasedParticipant receiver)

{

     NSArray *recipients = @[receiver];

     [self sendExchangeToParticipants:recipients data:data localizableMessageKey:key arguments:arguments timeout:timeout completionHandler:^(GKTurnBasedExchange *exchange, NSError *error) {

          // refresh your match data

     }];

}

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

Перечисление 10-11  , Отменяющее обменный запрос

-(void)player:(GKPlayer *)player exchangeCanceled:(GKTurnBasedExchange *)exchange match:(GKTurnBasedMatch *)match

{

     // update your match data to show the canceled request

}

Ответ на запрос Exchange

После того, как обменный запрос создается, проигрыватели в массиве получателей получают уведомление нажатия. Открытие игры представит обменное сообщение. Получатель может принять решение реагировать на обменный запрос или позволить ему испытать таймаут. Рисунок 10-6 показывает принятие Келли торговля Fred ' s и ответ на его обменный запрос. После того, как обмен завершается, обменный результат отправляется в текущий проигрыватель. Обмен согласован в конце очереди текущего проигрывателя.

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

Перечисление 10-12  , Отвечающее на обменный запрос

-(void) replyToExchange

{

     [self replyWithLocalizableMessageKey:key arguments:arguments data:data completionHandler:^(NSError *error) {

          // refresh your match data

     }

}