<!--
{
  "availability" : [
    "iOS: 5.0.0 -",
    "iPadOS: 5.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.8.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKTurnBasedMatchmakerViewControllerDelegate",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(pl)GKTurnBasedMatchmakerViewControllerDelegate"
  },
  "title" : "GKTurnBasedMatchmakerViewControllerDelegate"
}
-->

# GKTurnBasedMatchmakerViewControllerDelegate

A protocol that handles when the status of turn-based matchmaking changes.

```
protocol GKTurnBasedMatchmakerViewControllerDelegate : NSObjectProtocol
```

## Overview

To receive notifications when a player cancels turn-based matchmaking or an error occurs, implement this protocol in the [`GKTurnBasedMatchmakerViewController`](/documentation/GameKit/GKTurnBasedMatchmakerViewController) object’s delegate.

## Topics

### Handling Cancellation and Errors

[`-  turnBasedMatchmakerViewControllerWasCancelled:`](/documentation/GameKit/GKTurnBasedMatchmakerViewControllerDelegate/turnBasedMatchmakerViewControllerWasCancelled(_:))

Handles when the player dismisses the view controller without inviting players.

[`-  turnBasedMatchmakerViewController:didFailWithError:`](/documentation/GameKit/GKTurnBasedMatchmakerViewControllerDelegate/turnBasedMatchmakerViewController(_:didFailWithError:))

Handles when an error occurs while the local player invites other players.

### Deprecated Methods

[`-  turnBasedMatchmakerViewController:didFindMatch:`](/documentation/GameKit/GKTurnBasedMatchmakerViewControllerDelegate/turnBasedMatchmakerViewController(_:didFind:))

Handles when the view controller finds participants for a turn-based match.

[`-  turnBasedMatchmakerViewController:playerQuitForMatch:`](/documentation/GameKit/GKTurnBasedMatchmakerViewControllerDelegate/turnBasedMatchmakerViewController(_:playerQuitFor:))

Handles when a player quits the match.

## Relationships

### Inherits From

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

---

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)