UnityGame/Library/PackageCache/com.unity.inputsystem/Documentation~/SupportedDevices.md
2024-10-27 10:53:47 +03:00

6.7 KiB

uid
input-system-supported-devices

Supported Input Devices

This page lists Input Device types and products that the Input System package supports, and the platforms they're supported on.

Generic

Support for the following Devices doesn't require specialized support of particular products.

Device Windows Mac Linux UWP Android iOS tvOS Xbox(3) PS4(3) Switch(3) WebGL
Mouse Yes Yes Yes Yes Yes No No Yes Yes No Yes
Keyboard Yes Yes Yes Yes Yes No No Yes Yes No Yes
Pen Yes No (1) No Yes Yes Yes No No No No No
Touchscreen Yes No No Yes Yes Yes Yes(4) No No No Yes
Sensors No No No No Yes Yes No No No No Yes(5)
Joystick (2) Yes Yes Yes Yes Yes No No No No No Yes

Notes:

  1. Tablet support for macOS is coming in Unity 2020.1.
  2. Joysticks are supported as generic HIDs (See Other gamepads, joysticks, and racing wheels below).
  3. Consoles are supported using separate packages. You need to install these packages in your Project to enable console support.
  4. Indirect touches are received from Siri Remote.
  5. Sensor support for WebGL on Android and iOS devices is available in Unity 2021.2

Gamepads

Device Windows Mac Linux UWP(13) Android iOS(6) tvOS(6) Xbox(7) PS4/PS5(7) Switch(7) WebGL
Xbox 360 (4) Yes Yes (3) Yes Yes No No No Yes No No Sometimes (2)
Xbox One Yes (1) Yes (3) Yes (1) Yes Yes (1) Yes (6) Yes (6) Yes No No Sometimes (2)
PS3/PS4 Yes (5) Yes (5) Yes (5) Yes (5) Yes (5, 8) Yes (5, 6) Yes (5, 6) No Yes No Sometimes (2)
PS5 Yes (11) Yes (11) No (11) Yes (11) Yes (9, 11) No (11) No (11) No Yes No Sometimes (2)
Switch Yes (10) Yes (10) Yes Yes No No No No No Yes Sometimes (2)
MFi (such as SteelSeries) No Sometimes (12) No No No Yes Yes No No No No

Notes:

  1. The trigger motors on the Xbox One controller are only supported on UWP and Xbox.
  2. WebGL support varies between browsers, Devices, and operating systems.
  3. XInput controllers on Mac currently require the installation of the Xbox Controller Driver for macOS. This driver only supports only USB connections, and doesn't support wireless dongles. However, the latest generation of Xbox One controllers natively support Bluetooth, and are natively supported on Macs as HIDs without any additional drivers when connected via Bluetooth.
  4. This includes any XInput-compatible Device.
  5. Unity doesn't support motor rumble and lightbar color over Bluetooth. Unity doesn't support the gyro or accelerometer on PS4/PS5 controllers on platforms other than the PlayStation consoles. Unity also doesn't support the DualShock 4 USB Wireless Adaptor. On UWP only USB connection is supported, motor rumble and lightbar are not working correctly.
  6. Unity supports Made for iOS (Mfi) certified controllers on iOS. Xbox One and PS4 controllers are only supported on iOS 13 or higher.
  7. Consoles are supported using separate packages. You need to install these packages in your Project to enable console support.
  8. Unity supports PS4 controllers on Android devices running Android 10 or higher.
  9. Unity supports PS5 controllers on Android devices running Android 12 or higher.
  10. Switch Joy-Cons are not currently supported on Windows and Mac. Some of official accessories are supported on Windows and Mac: "Hori Co HORIPAD for Nintendo Switch", "HORI Pokken Tournament DX Pro Pad", "HORI Wireless Switch Pad", "HORI Real Arcade Pro V Hayabusa in Switch Mode", "PowerA NSW Fusion Wired FightPad", "PowerA NSW Fusion Pro Controller (USB only)", "PDP Wired Fight Pad Pro: Mario", "PDP Faceoff Wired Pro Controller for Nintendo Switch", "PDP Faceoff Deluxe Wired Pro Controller for Nintendo Switch", "PDP Afterglow Wireless Switch Controller", "PDP Rockcandy Wired Controller".
  11. PS5 DualSense is supported on Windows and macOS via USB HID, though setting motor rumble and lightbar color when connected over Bluetooth is currently not supported.
  12. SteelSeries Nimbus+ supported via HID on macOS. On UWP only USB connection is supported, motor rumble and lightbar are not working correctly. On Android it's expected to be working from Android 12. On iOS/tvOS it's currently recognized as a generic gamepad and most controls do work.
  13. To ensure all controller types are detected on UWP, enable the HumanInterfaceDevice setting in UWP Player Settings.

WebGL

The Input System supports the Standard Gamepad mapping as specified in the W3C Gamepad Specification. It also supports gamepads and joysticks that the browser surfaces without a mapping, but this support is generally limited to detecting the axes and buttons which are present, without any context as to what they mean. This means gamepads and joysticks are generally only useful when the user manually remaps them. The Input System reports these Devices as generic Joysticks.

Support varies between browsers, Devices, and operating systems, and further differs for different browser versions, so it's not feasible to provide an up-to-date compatibility list. At the time of this publication (September 2019), Safari, Chrome, Edge, and Firefox all support the gamepad API, but only Chrome reliably maps common gamepads (Xbox and PlayStation controllers) to the W3C Standard Gamepad mapping, which allows the Input System to correctly identify and map controls.

Note

: WebGL currently doesn't support rumble.

Other gamepads, joysticks, and racing wheels

The Input System supports any Device which implements the USB HID specification. However, for Devices which don't have specific layouts implemented in the Input System, the system can only surface the information available from the HID descriptor of the Device, which limits how precisely it can describe a control. These Devices often work best when allowing the user to manually remap the controls. If you need to support a specific Device, you can also add your own mapping for it. See documentation on HID for more information.