---
title: "player(_:didRequestMatchWithPlayers:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkturnbasedeventlistener/player(_:didrequestmatchwithplayers:)"
---

# player(_:didRequestMatchWithPlayers:)

Handles when the player uses Game Center to start a match with other players.

## Declaration

```swift
optional func player(_ player: GKPlayer, didRequestMatchWithPlayers playerIDsToInvite: [String])
```

## Parameters

- `player`: The player who receives this turn-based event. .
- `playerIDsToInvite`: The identifiers for the players to invite in the view controller interface.

## Discussion

Discussion Implement this method to present a GKTurnBasedMatchmakerViewController configured with the players to invite specified by the playerIDsToInvite parameter.

## See Also

### Handling Match-Related Events

- [player(_:receivedTurnEventFor:didBecomeActive:)](gamekit/gkturnbasedeventlistener/player(_:receivedturneventfor:didbecomeactive:).md)
- [player(_:didRequestMatchWithOtherPlayers:)](gamekit/gkturnbasedeventlistener/player(_:didrequestmatchwithotherplayers:).md)
- [player(_:matchEnded:)](gamekit/gkturnbasedeventlistener/player(_:matchended:).md)
- [player(_:wantsToQuitMatch:)](gamekit/gkturnbasedeventlistener/player(_:wantstoquitmatch:).md)