---
title: Racing wheel device support
framework: Game Controller
role: collectionGroup
role_heading: API Collection
path: gamecontroller/racing-wheel-device-support
---

# Racing wheel device support

Add support for racing wheel devices in macOS.

## Overview

Overview For macOS apps that support racing wheel devices, follow these steps for your app: If you distribute your app through the Mac App Store, add the com.apple.security.device.usb entitlement to your Xcode project. To get a racing wheel controller object, register for the GCRacingWheelDidConnect (Swift) or  GCRacingWheelDidConnectNotification (Objective-C) and GCRacingWheelDidDisconnect (Swift) or GCRacingWheelDidDisconnectNotification (Objective-C) notifications. Alternatively, check the GCRacingWheel connectedRacingWheels class property for the currently connected controllers. To start receiving input from a racing wheel controller, invoke the GCRacingWheel acquireDevice() method. Then use the relinquishDevice() method when you finish processing input. To process the input, set callbacks for the specific racing wheel elements that you want to receive input from. For example, set the valueDidChangeHandler property of the steering wheel and accelerator pedal elements. Get these elements using the wheel and acceleratorPedal properties of the racing wheel’s wheelInput property, as in: racingWheel.wheelInput.wheel. If you just want the latest value of the steering wheel, use the GCSteeringWheelElement absoluteInput property. For games that poll for input, set the input buffer size using the inputStateQueueDepth property. In each iteration of your game loop, repeatedly invoke the nextInputState() method until the queue is empty and it returns nil.

## Topics

### Racing wheel controller

- [GCRacingWheel](gamecontroller/gcracingwheel.md)

### Racing wheel input

- [GCRacingWheelInput](gamecontroller/gcracingwheelinput.md)
- [GCRacingWheelInputState](gamecontroller/gcracingwheelinputstate.md)

### Left and right paddles

- [GCInputLeftPaddle](gamecontroller/gcinputleftpaddle-77y86.md)
- [GCInputRightPaddle](gamecontroller/gcinputrightpaddle-5klic.md)

### Gear shifter elements

- [GCAxisInput](gamecontroller/gcaxisinput.md)
- [GCGearShifterElement](gamecontroller/gcgearshifterelement.md)
- [GCRelativeInput](gamecontroller/gcrelativeinput.md)

### Steering and switch elements

- [GCSteeringWheelElement](gamecontroller/gcsteeringwheelelement.md)
- [GCSwitchPositionInput](gamecontroller/gcswitchpositioninput.md)

### Directional pad elements

- [GCLinearInput](gamecontroller/gclinearinput.md)