---
title: "addRecipientPlayers(_:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkfriendrequestcomposeviewcontroller/addrecipientplayers(_:)"
---

# addRecipientPlayers(_:)

Adds recipients based on their Game Center player identifiers.

## Declaration

```swift
func addRecipientPlayers(_ players: [GKPlayer])
```

## Parameters

- `players`: An array with one or more doc://com.apple.gamekit/documentation/GameKit/GKPlayer objects, each containing an player identifier.

## Discussion

Discussion If you do not add at least once recipient, the recipients field is selected when the view controller is presented so that the player can type a list of recipients. Adding more players than defined by the maxNumberOfRecipients() property causes an exception to be thrown.

## See Also

### Adding Recipients

- [addRecipients(withEmailAddresses:)](gamekit/gkfriendrequestcomposeviewcontroller/addrecipients(withemailaddresses:).md)
- [addRecipients(withPlayerIDs:)](gamekit/gkfriendrequestcomposeviewcontroller/addrecipients(withplayerids:).md)