|
1 | 1 | # Installation guide
|
2 | 2 |
|
| 3 | +* [Installing the package](#installing-the-package) |
| 4 | +* [Enabling the new input backends](#enabling-the-new-input-backends) |
| 5 | +* [Installing samples](#installing-samples) |
| 6 | + |
3 | 7 | This guide describes how to install and activate the Input System package for your Unity Project.
|
4 | 8 |
|
5 | 9 | >__Note__: The new Input System requires Unity 2019.1+ and the .NET 4 runtime. It doesn't work in projects using the old .NET 3.5 runtime.
|
6 | 10 |
|
7 | 11 | ## Installing the package
|
8 | 12 |
|
9 |
| -To install the new Input System, open Unity's package manager (menu: __Window > Package Manager__). The Input System is in Preview, so to see the package in the package list, select the __Advanced__ dropdown, and enable __Show Preview Packages__. |
10 |
| - |
11 |
| - |
12 |
| - |
13 |
| -Select the latest __Input System__ package from the list, then click __Install__. |
| 13 | +To install the new Input System, open Unity's package manager (menu: __Window > Package Manager__). Select the __Input System__ package from the list, then click __Install__. |
14 | 14 |
|
15 | 15 | 
|
16 | 16 |
|
17 | 17 | ## Enabling the new input backends
|
18 | 18 |
|
19 |
| -By default, Unity's classic Input Manager is active and support for the new Input System is inactive. This allows existing Unity Projects to keep working as they are. |
| 19 | +By default, Unity's classic Input Manager (`UnityEngine.Input`) is active and support for the new Input System is inactive. This allows existing Unity Projects to keep working as they are. |
20 | 20 |
|
21 |
| -To fully switch from the old Input Manager to the new Input System for a Project: |
| 21 | +When you install the Input System package, Unity will ask whether you want to enable the new backends. If you click **Yes**, Unity will enable the new backends and disable the old backends, and the Editor will restart. |
22 | 22 |
|
23 |
| -1. Open the Player settings (menu: __Edit > Project Settings > Player__). |
24 |
| -2. Change Active Input Handling to __Input System Package (New)__ (or __Input System (Preview)__ in Unity 2019.2 or older). |
| 23 | + |
25 | 24 |
|
26 |
| - |
| 25 | +You can find the corresponding setting in the Player settings (menu: __Edit > Project Settings > Player__), under **Active Input Handling**. You can change this setting at any time. Doing so will restart the Editor. |
27 | 26 |
|
28 |
| ->__Note__: You must restart the Unity Editor before this setting takes effect. |
| 27 | +>**Note:** You can enable __both__ the old __and__ the new system at the same time. To do so, set **Active Input Handling** to **Both**. |
29 | 28 |
|
30 | 29 | When the new input backends are enabled, the `ENABLE_INPUT_SYSTEM=1` C# `#define` is added to builds. Similarly, when the old input backends are enabled, the `ENABLE_LEGACY_INPUT_MANAGER=1` C# `#define` is added. Because both can be enabled at the same time, it is possible for __both__ defines to be 1 at the same time.
|
| 30 | + |
| 31 | +## Installing samples |
| 32 | + |
| 33 | +The Input System package comes with a number of samples. You can install these directly from the Package Manager window in Unity (menu: __Window > Package Manager__). To see the list, select the Input System package in the Package Manager window. Click **Import into Project** next to a sample to copy it into the current Project. |
| 34 | + |
| 35 | + |
0 commit comments