Xbox gamepads

The Input System implements Xbox gamepads using the XInputController class, which derives from Gamepad. On Windows and Universal Windows Platform, Unity uses the XInput API to connect to any type of supported XInput controller, including all Xbox One or Xbox 360-compatible controllers. These controllers are represented as an XInputController instance.

You can query the XInputController.subType property to get information about the type of controller (for example, a wheel or a gamepad).

On other platforms, Unity uses derived classes to represent Xbox controllers:

  • XboxGamepadMacOS: Any Xbox or compatible gamepad connected to a Mac with USB using the Xbox Controller Driver for macOS. This class is only used when the 360Controller driver is in use, and as such you shouldn't see it in use on modern versions of macOS - it is provided primarily for legacy reasons, and for scenarios where macOS 10.15 may still be used.

  • XboxGamepadMacOSNative: Any Xbox gamepad connected to a Mac (macOS 11.0 or higher) with USB. On modern macOS versions, you will get this class instead of XboxGamepadMacOS.

  • XboxOneGampadiOS: An Xbox One controller connected to an iOS device with Bluetooth. Requires iOS 13 or higher.

XInput controllers on macOS require the installation of the Xbox Controller Driver for macOS. This driver only supports USB connections, and doesn't support wireless dongles. However, the latest generation of Xbox One controllers natively support Bluetooth. macOS natively supports these controllers as HID devices without any additional drivers when connected with Bluetooth.

Unity supports Xbox controllers on WebGL in some browser and OS configurations, but treats them as basic Gamepad or Joystick devices, and doesn't support rumble or any other Xbox-specific functionality.

For more information on platform support for Xbox gamepads, refer to Supported devices reference.