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

# player(_:didRequestMatchWithPlayers:)

Handles the event when the local player sends other players an invitation to join a match.

## Declaration

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

## Parameters

- `player`: The local player who sends the invitation.
- `playerIDsToInvite`: The identifiers for the players who receive invitations to join the match.

## Discussion

Discussion When you call this method, GameKit launches the game and starts the matchmaking process.

## See Also

### Starting a New Match

- [player(_:didAccept:)](gamekit/gkinviteeventlistener/player(_:didaccept:).md)
- [player(_:didRequestMatchWithRecipients:)](gamekit/gkinviteeventlistener/player(_:didrequestmatchwithrecipients:).md)