<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.9.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameController",
  "identifier" : "/documentation/GameController/GCExtendedGamepad",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Game Controller"
    ],
    "preciseIdentifier" : "c:objc(cs)GCExtendedGamepad"
  },
  "title" : "GCExtendedGamepad"
}
-->

# GCExtendedGamepad

A controller profile that supports the extended set of gamepad controls.

```
class GCExtendedGamepad
```

## Overview

The extended gamepad controller profile represents a physical or virtual controller with the following input elements:

- Two shoulder buttons
- Two trigger buttons
- Four face buttons in a diamond pattern
- One directional pad
- Two thumbsticks with optional thumbstick buttons
- Optional Home and Options buttons
- A Menu button

![An illustration of an extended gamepad controller with callouts for the buttons and controls.](images/com.apple.gamecontroller/media-3850406@2x.png)

If a [`GCController`](/documentation/GameController/GCController) object supports this type of profile, get the input values of the elements from the controller’s [`extendedGamepad`](/documentation/GameController/GCController/extendedGamepad) property or use the profile’s [`valueChangedHandler`](/documentation/GameController/GCExtendedGamepad/valueChangedHandler) method to receive a callback when the input values change. Alternatively, use the [`saveSnapshot()`](/documentation/GameController/GCExtendedGamepad/saveSnapshot()) method to capture the input values at a moment in time.

If the controller’s [`extendedGamepad`](/documentation/GameController/GCController/extendedGamepad) property is `nil`, the controller doesn’t support this type of profile. See [`GCController`](/documentation/GameController/GCController) for other profiles you can use.

## Topics

### Getting the controller

[`controller`](/documentation/GameController/GCExtendedGamepad/controller)

The controller for the profile.

### Getting change information

[`valueChangedHandler`](/documentation/GameController/GCExtendedGamepad/valueChangedHandler)

The block that the profile calls when an element’s value changes.

[`GCExtendedGamepadValueChangedHandler`](/documentation/GameController/GCExtendedGamepadValueChangedHandler)

The signature for the block that the profile calls when an element’s value changes.

### Getting shoulder button inputs

[`leftShoulder`](/documentation/GameController/GCExtendedGamepad/leftShoulder)

The controller’s left shoulder button element.

[`rightShoulder`](/documentation/GameController/GCExtendedGamepad/rightShoulder)

The controller’s right shoulder button element.

### Getting trigger inputs

[`leftTrigger`](/documentation/GameController/GCExtendedGamepad/leftTrigger)

The controller’s left trigger element.

[`rightTrigger`](/documentation/GameController/GCExtendedGamepad/rightTrigger)

The controller’s right trigger element.

### Getting face button inputs

[`buttonMenu`](/documentation/GameController/GCExtendedGamepad/buttonMenu)

The primary menu button element that players use to enter the main menu and pause the game.

[`buttonOptions`](/documentation/GameController/GCExtendedGamepad/buttonOptions)

The controller’s secondary menu button element.

[`buttonHome`](/documentation/GameController/GCExtendedGamepad/buttonHome)

The main menu button element that players use to enter the secondary menu and pause the game.

[`buttonA`](/documentation/GameController/GCExtendedGamepad/buttonA)

The bottom face button that uses *A* or another indicator as its label.

[`buttonB`](/documentation/GameController/GCExtendedGamepad/buttonB)

The right face button that uses *B* or another indicator as its label.

[`buttonX`](/documentation/GameController/GCExtendedGamepad/buttonX)

The left face button that uses *X* or another indicator as its label.

[`buttonY`](/documentation/GameController/GCExtendedGamepad/buttonY)

The top face button that uses *Y* or another indicator as its label.

### Getting directional pad inputs

[`dpad`](/documentation/GameController/GCExtendedGamepad/dpad)

The controller’s directional pad element.

### Getting thumbstick and thumbstick button inputs

[`leftThumbstick`](/documentation/GameController/GCExtendedGamepad/leftThumbstick)

The controller’s left thumbstick element.

[`rightThumbstick`](/documentation/GameController/GCExtendedGamepad/rightThumbstick)

The controller’s right thumbstick element.

[`leftThumbstickButton`](/documentation/GameController/GCExtendedGamepad/leftThumbstickButton)

The button on the left thumbstick of the controller.

[`rightThumbstickButton`](/documentation/GameController/GCExtendedGamepad/rightThumbstickButton)

The button on the right thumbstick of the controller.

### Accessing elements by name

[Extended gamepad input names](/documentation/GameController/extended-gamepad-input-names)

Constants for names of extended gamepad elements.

### Setting snapshot values

[`setStateFrom(_:)`](/documentation/GameController/GCExtendedGamepad/setStateFrom(_:))

Copies the input values from a specified extended gamepad to a snapshot of an extended gamepad.

[`saveSnapshot()`](/documentation/GameController/GCExtendedGamepad/saveSnapshot())

Saves a snapshot of all of the profile’s elements.


---

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)