Skip to content
Open
Show file tree
Hide file tree
Changes from 14 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
84d68d3
Added missing UIDs to manual pages
unitALG Sep 19, 2025
0d6fc6f
Normalized "NOTE" and "IMPORTANT" admonitions throughout docs
unitALG Sep 23, 2025
84b9195
Merge branch 'develop' into docatt-manual-page-edits
unitALG Sep 23, 2025
bac9b88
Fixed two more irregular admonitions in ActionBindings.md
unitALG Sep 23, 2025
1530297
Image fixes for consistency and web accessibility
unitALG Sep 23, 2025
3e0f524
DOCATT-9373: Removed the incomplete sentence in the Canceled property
unitALG Sep 25, 2025
69461db
DOCATT-8578: Merged repeated information on Control paths
unitALG Sep 26, 2025
10e63ef
DOCATT-8537: Clarified the installation requirements
unitALG Sep 26, 2025
b520e21
Removed redundant mini-TOCs that appear on random pages
unitALG Sep 26, 2025
13e4c94
Bulk-replaced all relative paths and links to Engine docs with xrefs
unitALG Oct 2, 2025
3e3f4a1
DOCATT-8743: Edited PlayerInput class for clarity, made more explicit
unitALG Oct 3, 2025
8e997c2
Ran reformatting tool
unitALG Oct 3, 2025
15d1a64
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 3, 2025
397ba02
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 6, 2025
7724d42
Merge branch 'develop' into docatt-substantial-doc-edits
ekcoh Oct 14, 2025
a02dd90
Update PlayerInput.cs
ekcoh Oct 15, 2025
538e346
Merge branch 'develop' into docatt-substantial-doc-edits
ekcoh Oct 21, 2025
a0f111b
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 23, 2025
597f34a
Follow-up edits for consistency after reviews
unitALG Oct 27, 2025
6ef249b
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 27, 2025
b584e3a
Re-formatted changes in code samples in MD files
unitALG Oct 27, 2025
47d812d
Fixed typos and reorganized sections in Input Actions Editor page
unitALG Oct 27, 2025
b2df3dd
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 28, 2025
a8f6233
Fixed failing tests for images:
unitALG Oct 28, 2025
adf863d
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 28, 2025
bcf9dbf
Attempted to fix link errors reported by Windows functional tests
unitALG Oct 29, 2025
947fe8c
Test whether the NDA validation still fails with a relative path
unitALG Oct 29, 2025
e153008
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 30, 2025
2d5ded3
Fixed missing xref: in link
unitALG Oct 30, 2025
c0e5886
Merge branch 'develop' into docatt-substantial-doc-edits
unitALG Oct 31, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions Packages/com.unity.inputsystem/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -430,7 +430,7 @@ however, it has to be formatted properly to pass verification tests.
- Fixed issue of visual elements being null during editing project-wide actions in project settings which prompted console errors.
- Fixed case ISX-1436 (UI TK Input Action Asset Editor - Error deleting Bindings with DeleteKey on Windows).
- Fixed issue with UI Toolkit based Input Action Editor not restoring it's selected items after Domain Reload.
- Fixed the [`GetHapticCapabilitiesCommand`](xref:UnityEngine.InputSystem.XR.Haptics.GetHapticCapabilitiesCommand) always failing to execute due to a mismatch in the size in bytes of the payload and the size expected by XR devices. Changed [`HapticCapabilities`](xref:UnityEngine.InputSystem.XR.Haptics.HapticCapabilities) to include all properties returned by the XR input subsystem. This makes Input System match the functionality provided by the [XR](https://docs.unity3d.com/Manual/com.unity.modules.xr.html) module's [`InputDevice.TryGetHapticCapabilities`](https://docs.unity3d.com/ScriptReference/XR.InputDevice.TryGetHapticCapabilities.html) and [`HapticCapabilities`](https://docs.unity3d.com/ScriptReference/XR.HapticCapabilities.html).
- Fixed the [`GetHapticCapabilitiesCommand`](xref:UnityEngine.InputSystem.XR.Haptics.GetHapticCapabilitiesCommand) always failing to execute due to a mismatch in the size in bytes of the payload and the size expected by XR devices. Changed [`HapticCapabilities`](xref:UnityEngine.InputSystem.XR.Haptics.HapticCapabilities) to include all properties returned by the XR input subsystem. This makes Input System match the functionality provided by the [XR](https://docs.unity3d.com/Manual/com.unity.modules.xr.html) module's [`InputDevice.TryGetHapticCapabilities`](xref:UnityEngine.XR.InputDevice.TryGetHapticCapabilities(UnityEngine.XR.HapticCapabilities&)) and [`HapticCapabilities`](xref:UnityEngine.XR.HapticCapabilities).
- Fixed issue where deleting a binding in the Input Action Editor would usually result in an unexpected item being selected next.

## [1.8.0-pre.1] - 2023-09-04
Expand Down Expand Up @@ -1866,7 +1866,8 @@ This release includes a number of Quality-of-Life improvements for a range of co

- **The system no longer supports processing input in __BOTH__ fixed and dynamic updates**. Instead, a choice has to be made whether to process input before each `FixedUpdate()` or before each `Update()`.
* Rationale: the existing code that supported having both updates receive input independently still had several holes and became increasingly complex and brittle. Our solution was based on not actually processing input twice but on channeling input concurrently into both the state of both updates. Together with the fact that specific inputs have to reset (and possibly accumulate) correctly with respect to their update time slices, this became increasingly hard to do right. This, together with the fact that we've come to increasingly question the value of this feature, led us to removing the capability while preserving the ability to determine where input is processed.
* NOTE: Timeslicing is NOT affected by this. You can still switch to `ProcessEventInFixedUpdates` and get events timesliced to individual `FixedUpdate` periods according to their timestamps.
> [!NOTE]
> Timeslicing is NOT affected by this. You can still switch to `ProcessEventInFixedUpdates` and get events timesliced to individual `FixedUpdate` periods according to their timestamps.
* `InputSettings.UpdateMode.ProcessEventsInBothFixedAndDynamicUpdate` has been removed.
* `InputSettings.UpdateMode.ProcessEventsInDynamicUpdateOnly` has been renamed to `InputSettings.UpdateMode.ProcessEventsInDynamicUpdate` and is now the default.
* `InputSettings.UpdateMode.ProcessEventsInFixedUpdateOnly` has been renamed to `InputSettings.UpdateMode.ProcessEventsInFixedUpdate`.
Expand Down Expand Up @@ -2067,9 +2068,10 @@ This release includes a number of Quality-of-Life improvements for a range of co

## [0.2.6-preview] - 2019-03-20

>NOTE: The UI code for editing actions has largely been rewritten. There may be regressions.
>NOTE: The minimum version requirement for the new input system has been bumped
to 2019.1
> [!NOTE]
> The UI code for editing actions has largely been rewritten. There may be regressions.
>
> The minimum version requirement for the new input system has been bumped to 2019.1

### Added

Expand Down Expand Up @@ -2147,7 +2149,8 @@ This release includes a number of Quality-of-Life improvements for a range of co

This release contains a number of fairly significant changes. The focus has been on further improving the action system to make it easier to use as well as to make it work more reliably and predictably.

>NOTE: There are some breaking changes. Please see the "Changed" section below.
> [!NOTE]
> There are some breaking changes. Please see the "Changed" section below.

### Changed

Expand Down Expand Up @@ -2283,10 +2286,11 @@ This release contains a number of fairly significant changes. The focus has been

## [0.1.2-preview] - 2018-12-19

NOTE: The minimum version requirement for the new input system has been bumped
to 2018.3. The previous minum requirement of 2018.2 is no longer supported.
Also, we have dropped support for the .NET 3.5 runtime. The new .NET 4
runtime is now required to use the new input system.
> [!NOTE]
> The minimum version requirement for the new input system has been bumped
> to 2018.3. The previous minum requirement of 2018.2 is no longer supported.
> Also, we have dropped support for the .NET 3.5 runtime. The new .NET 4
> runtime is now required to use the new input system.

We've started working on documentation. The current work-in-progress can be found on [GitHub](https://github.com/Unity-Technologies/InputSystem/blob/develop/Packages/com.unity.inputsystem/Documentation~/InputSystem.md).

Expand Down
25 changes: 11 additions & 14 deletions Packages/com.unity.inputsystem/Documentation~/ActionAssets.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,27 +3,22 @@ uid: input-system-action-assets
---
# Input Action Assets

- [Creating Input Action Assets](#creating-input-action-assets)
- [Editing Input Action Assets](#editing-input-action-assets)
- [Using Input Action Assets](#using-input-action-assets)
- [Type-safe C# API Generation](#type-safe-c-api-generation)
An Input Action Asset is an Asset which contains a set of [Input Actions](xref:input-system-actions) definitions and their associated [Bindings](xref:input-system-action-bindings) and [Control Schemes](xref:input-system-action-bindings#control-schemes). These Assets have the `.inputactions` file extension and are stored in a plain JSON format.

An Input Action Asset is an Asset which contains a set of [Input Actions](Actions.md) definitions and their associated [Bindings](ActionBindings.md) and [Control Schemes](ActionBindings.md#control-schemes). These Assets have the `.inputactions` file extension and are stored in a plain JSON format.

The input system creates an Action Asset when you set up the [default project-wide actions](ProjectWideActions.md), but you can also create new Action Assets directly in the Project window.
The input system creates an Action Asset when you set up the [default project-wide actions](xref:project-wide-actions), but you can also create new Action Assets directly in the Project window.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We say "Action Asset" in this paragraph but "Input Action Asset" in the previous paragraph, shouldn't they be consistent?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, absolutely. Unfortunately, I didn't have time to search for consistencies and apply our standards to all MD files, just a handful. The only changes to this file that I made were to switch the links to use xrefs, remove the mini-TOCs at the beginning and to change the Note blocks to use DocFx standard components.

But since you flagged it, I will make another pass on the file to apply consistency.


For most common scenarios, you do not need to use more than one Input Action Asset. It is usually simpler to configure your project-wide action definition in the Project Settings window.


## Creating Input Action Assets

To create an Asset that contains [Input Actions](Actions.md) in Unity, right-click in the __Project__ window or go to __Assets > Create > Input Actions__ from Unity's main menu.
To create an Asset that contains [Input Actions](xref:input-system-actions) in Unity, right-click in the __Project__ window or go to __Assets > Create > Input Actions__ from Unity's main menu.

## Editing Input Action Assets

To bring up the Action editor, double-click an `.inputactions` Asset in the Project Browser, or select the __Edit Asset__ button in the Inspector for that Asset. You can have more than one editor window open at the same time, but not for the same Asset.

The Actions Editor which opens is identical to the [Actions Editor in the Project Settings window](ActionsEditor.md).
The Actions Editor which opens is identical to the [Actions Editor in the Project Settings window](xref:input-system-configuring-input).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here we call it Actions Editor again. Just looking for what they should be called for consistency.



## Using Input Action Assets
Expand Down Expand Up @@ -90,21 +85,22 @@ public class MyPlayerScript : MonoBehaviour, IGameplayActions
}
```

>__Note__: To regenerate the .cs file, right-click the .inputactions asset in the Project Browser and choose "Reimport".
> [!NOTE]
> To regenerate the .cs file, right-click the .inputactions asset in the Project Browser and choose "Reimport".

### Using Action Assets with `PlayerInput`

The [Player Input](PlayerInput.md) component provides a convenient way to handle input for one or multiple players. You can assign your Action Asset to the Player Input component so that it can then automatically handle activating Action Maps and selecting Control Schemes for you.
The [Player Input](xref:input-system-player-input) component provides a convenient way to handle input for one or multiple players. You can assign your Action Asset to the Player Input component so that it can then automatically handle activating Action Maps and selecting Control Schemes for you.

![PlayerInput](Images/PlayerInput.png)

### Modifying Input Action Assets at runtime
There are several ways to modify an Input Action Asset at runtime. Any modifications that you make during Play mode to an Input Action Asset do not persist in the Input Action Asset after you exit Play mode. This means you can test your application in a realistic manner in the Editor without having to worry about inadvertently modifying the asset. For examples on how to modify an Input Action Asset, see the documentation on [Creating Actions in code](Actions.md#creating-actions-in-code) and [Changing Bindings](ActionBindings.md#changing-bindings).
There are several ways to modify an Input Action Asset at runtime. Any modifications that you make during Play mode to an Input Action Asset do not persist in the Input Action Asset after you exit Play mode. This means you can test your application in a realistic manner in the Editor without having to worry about inadvertently modifying the asset. For examples on how to modify an Input Action Asset, see the documentation on [Creating Actions in code](xref:input-system-actions#creating-actions-in-code) and [Changing Bindings](xref:input-system-action-bindings#changing-bindings).


### The Default Actions Asset

An asset called `DefaultInputActions.inputactions` containing a default setup of Actions comes with the Input System Package. You can reference this asset directly in your projects like any other Unity asset. However, the asset is also available in code form through the [`DefaultInputActions`](../api/UnityEngine.InputSystem.DefaultInputActions.html) class.
An asset called `DefaultInputActions.inputactions` containing a default setup of Actions comes with the Input System Package. You can reference this asset directly in your projects like any other Unity asset. However, the asset is also available in code form through the [`DefaultInputActions`](xref:UnityEngine.InputSystem.DefaultInputActions) class.

```CSharp
void Start()
Expand All @@ -117,4 +113,5 @@ void Start()
}
```

> __Note:__ This default actions asset is older than, and entirely separate from the [default project-wide actions](ProjectWideActions.md). It is a legacy asset that remains included in the package for backward compatibility.
> [!NOTE]
> This default actions asset is older than, and entirely separate from the [default project-wide actions](xref:project-wide-actions). It is a legacy asset that remains included in the package for backward compatibility.
Loading