InControl support XInput on Windows by wrapping XInput.NET. XInput provides a few distinct advantages for compatible controllers:
- It supports faster input polling than Unity's
Update()
loop which may be desirable for using input in physics update. - It bypasses Unity entirely, which can avoid certain bugginess Unity has with XInput controllers, although many of these issues have been fixed in versions 4.6.3 and 5.0.2
- It supports haptic feedback through two API calls on
InputDevice
:
public void Vibrate( float leftMotor, float rightMotor );
public void Vibrate( float intensity );
XInput support for InControl is disabled by default. To enable it check the option in the InControlManager
component inspector.
Unity 5
As of version 5, Unity has a new way of handling plugins, the Plugin Inspector. The latest version of InControl has both the 32 bit and 64 bit version included in the InControl/Plugins
folder. Unfortunately, the correct settings for the inspector do not seem to be included when packaged for the Asset Store, however it’s a simple process to set up each DLL correctly:
Unity 4
To use XInput with Unity 4, follow the instructions for using XInput.NET. Essentially, place XInputInterface32.dll
or XInputInterface64.dll
next to your .exe file and in the root of your Unity project (for running in the Unity Editor).
Make sure you are using the correct DLL build for your architecture. Some have had a problem with the version(s) included with InControl, although in recent releases both versions are included in the asset and renamed accordingly.
If you wish, you can grab the latest builds directly from the XInput.NET project releases page.
You will also need to ensure you have DirectX installed, and in particular XInput1_3.dll
is required. On some versions of Windows, the version of DirectX installed by default is too old, so make sure you upgrade DirectX if you’re having problems.
Advanced Settings
There are two advanced settings when XInput is enabled: Update Rate
and Buffer Size
. In almost all cases you’ll want to leave both as 0
which lets InControl determine sensible defaults.
For performance efficiency, InControl polls XInput state on a background thread. The Update Rate
determines how often this polling occurs. It defaults to using the fixed update rate.
The Buffer Size
determines how many state snapshots the background thread hangs onto in a ring buffer. In some cases when using input in physics steps it may be desirable to use a small buffer as Unity calls several fixed updates bunched up at the end of a standard update instead of spreading them out smoothly over each frame. The buffer set to the approximate size of these bunches allows for smoother input values over these fixed updates at the expense of a tiny amount of latency. This is mostly an experimental setting and is best left disabled (which is the default) unless you truly understand and care about it what it does.