GKTurnBasedEventListener

События дескрипторов для основанных на повороте игр. Обеспечивает методы для ответа на обмены и события соответствия.

Не реализовывать GKTurnBasedEventListener непосредственно, вместо этого используйте GKLocalPlayerListener. GKLocalPlayerListener протокол наследовал методы от GKTurnBasedEventListener, GKInviteEventListener, и GKChallengeListener для обработки многократных событий.

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

Не применимый

Соответствует

Не применимый

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

Swift

import GameKit

Objective C

@import GameKit;

Доступность

Доступный в OS X v10.10 и позже.

Обработка обменов


    
    проигрыватель (_: receivedExchangeCancellation:forMatch:)
    - player:receivedExchangeCancellation:forMatch:

Требуемый

Вызванный, когда обмен отменяется отправителем. (требуемый)

Объявление

Swift

optional func player(_ player: GKPlayer!, receivedExchangeCancellation exchange: GKTurnBasedExchange!, forMatch match: GKTurnBasedMatch!)

Objective C

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

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`exchange`	A `GKTurnBasedExchange` объект, содержащий отменяющийся обмен.
`match`	`GKTurnBasedMatch` объект, содержащий текущую информацию о соответствии.

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.


    
    проигрыватель (_: receivedExchangeReplies:forCompletedExchange:forMatch:)
    - player:receivedExchangeReplies:forCompletedExchange:forMatch:

Требуемый

Вызванный, когда завершается обмен. (требуемый)

Объявление

Swift

optional func player(_ player: GKPlayer!, receivedExchangeReplies replies: [AnyObject]!, forCompletedExchange exchange: GKTurnBasedExchange!, forMatch match: GKTurnBasedMatch!)

Objective C

- (void)player:(GKPlayer *)player receivedExchangeReplies:(NSArray *)replies forCompletedExchange:(GKTurnBasedExchange *)exchange forMatch:(GKTurnBasedMatch *)match

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`replies`	Массив `GKTurnBasedExchange` объекты, содержащие ответы от других проигрывателей.
`exchange`	A `GKTurnBasedExchange` объект, содержащий завершающийся обмен.
`match`	`GKTurnBasedMatch` объект, содержащий текущие игровые данные.

Обсуждение

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

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.


    
    проигрыватель (_: receivedExchangeRequest:forMatch:)
    - player:receivedExchangeRequest:forMatch:

Требуемый

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

Объявление

Swift

optional func player(_ player: GKPlayer!, receivedExchangeRequest exchange: GKTurnBasedExchange!, forMatch match: GKTurnBasedMatch!)

Objective C

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

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`exchange`	A `GKTurnBasedExchange` объект, содержащий требуемый обмен.
`match`	`GKTurnBasedMatch` объект, содержащий текущие игровые данные.

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.

Обработка соответствия связанные события


    
    проигрыватель (_: didRequestMatchWithOtherPlayers:)
    - player:didRequestMatchWithOtherPlayers:

Требуемый

Инициирует соответствие от Игрового Центра с требуемыми проигрывателями. (требуемый)

Объявление

Swift

optional func player(_ player: GKPlayer!, didRequestMatchWithOtherPlayers playersToInvite: [AnyObject]!)

Objective C

- (void)player:(GKPlayer *)player didRequestMatchWithOtherPlayers:(NSArray *)playersToInvite

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`playersToInvite`	Массив `GKPlayer` объекты, содержащие идентификаторы проигрывателя для приглашения в соответствие.

Обсуждение

Когда этот метод вызывают, необходимо создать новое соответствие с помощью предоставленных идентификаторов проигрывателя и представить a GKTurnBasedMatchmakerViewController.

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.


    
    проигрыватель (_: matchEnded:)
    - player:matchEnded:

Требуемый

Вызванный, когда закончился матч. (требуемый)

Объявление

Swift

optional func player(_ player: GKPlayer!, matchEnded match: GKTurnBasedMatch!)

Objective C

- (void)player:(GKPlayer *)player matchEnded:(GKTurnBasedMatch *)match

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`match`	`GKTurnBasedMatch` объект, содержащий текущие игровые данные.

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.


    
    проигрыватель (_: receivedTurnEventForMatch:didBecomeActive:)
    - player:receivedTurnEventForMatch:didBecomeActive:

Требуемый

Активирует очередь проигрывателя. (требуемый)

Объявление

Swift

optional func player(_ player: GKPlayer!, receivedTurnEventForMatch match: GKTurnBasedMatch!, didBecomeActive didBecomeActive: Bool)

Objective C

- (void)player:(GKPlayer *)player receivedTurnEventForMatch:(GKTurnBasedMatch *)match didBecomeActive:(BOOL)didBecomeActive

Параметры

`player`	`GKPlayer` объект, содержащий информацию текущего проигрывателя.
`match`	`GKTurnBasedMatch` объект, содержащий текущие игровые данные.
`didBecomeActive`	Обозначает, должно ли приложение быть запущено или принесено к переднему плану.

Обсуждение

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

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

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

Objective C

@import GameKit;

Swift

import GameKit

Доступность

Доступный в OS X v10.10 и позже.