<!--
{
  "availability" : [
    "iOS: 17.0.0 - 26.0.0",
    "iPadOS: 17.0.0 - 26.0.0",
    "macCatalyst: 17.0.0 - 26.0.0",
    "macOS: 14.0.0 - 26.0.0",
    "tvOS: 17.0.0 - 26.0.0",
    "visionOS: 1.0.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKScore/challengeComposeController(withMessage:players:completion:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(cs)GKScore(im)challengeComposeControllerWithMessage:players:completion:"
  },
  "title" : "challengeComposeController(withMessage:players:completion:)"
}
-->

# challengeComposeController(withMessage:players:completion:)

Provides a challenge compose view controller with preselected player identifiers and a preformatted, player-editable message.

iOS, iPadOS, Mac Catalyst, tvOS, visionOS:

```
func challengeComposeController(withMessage message: String?, players: [GKPlayer]?, completion completionHandler: GKChallengeComposeHandler? = nil) -> UIViewController
```

macOS:

```
func challengeComposeController(withMessage message: String?, players: [GKPlayer]?, completion completionHandler: GKChallengeComposeHandler? = nil) -> NSViewController
```

## Parameters

`message`

The challenge that GameKit sends to other players.

`players`

The players to invite to the challenge.

`completionHandler`

A block that GameKit calls after it displays the view controller.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)