Class InputActionSetupExtensions

Extensions to set up InputAction and InputActionMap.

Inheritance

System.Object

InputActionSetupExtensions

Namespace: UnityEngine.InputSystem

Syntax

public static class InputActionSetupExtensions

Methods

AddAction(InputActionMap, String, InputActionType, String, String, String, String, String)

Declaration

public static InputAction AddAction(this InputActionMap map, string name, InputActionType type = default(InputActionType), string binding = null, string interactions = null, string processors = null, string groups = null, string expectedControlLayout = null)

Parameters

Type	Name	Description
InputActionMap	map
System.String	name
InputActionType	type
System.String	binding
System.String	interactions
System.String	processors
System.String	groups
System.String	expectedControlLayout

Returns

Type	Description
InputAction

AddActionMap(InputActionAsset, String)

Declaration

public static InputActionMap AddActionMap(this InputActionAsset asset, string name)

Parameters

Type	Name	Description
InputActionAsset	asset
System.String	name

Returns

Type	Description
InputActionMap

AddBinding(InputAction, String, String, String, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputAction action, string path, string interactions = null, string processors = null, string groups = null)

Parameters

Type	Name	Description
InputAction	action
System.String	path
System.String	interactions
System.String	processors
System.String	groups

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

AddBinding(InputAction, InputBinding)

Add a new binding to the action.

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputAction action, InputBinding binding)

Parameters

Type	Name	Description
InputAction	action	A disabled action to add the binding to.
InputBinding	binding

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax	Returns a fluent-style syntax structure that allows performing additional modifications based on the new binding.

Remarks

This works both with actions that are part of an action set as well as with actions that aren't.

Note that actions must be disabled while altering their binding sets. Also, if the action belongs to a set, all actions in the set must be disabled.

AddBinding(InputAction, InputControl)

Add a binding that references the given control and triggers the given .

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputAction action, InputControl control)

Parameters

Type	Name	Description
InputAction	action	Action to trigger. Also determines where to add the binding. If the action is not part of an InputActionMap, the binding is added directly to action. If it is part of a map, the binding is added to the action map (actionMap).
InputControl	control	Control to binding to. The full path of the control will be used in the resulting InputBinding.

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax	Syntax to configure the binding further.

Exceptions

Type	Condition
System.ArgumentNullException	action is null or control is null.

See Also

bindings

AddBinding(InputActionMap, String, Guid, String, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputActionMap actionMap, string path, Guid action, string interactions = null, string groups = null)

Parameters

Type	Name	Description
InputActionMap	actionMap
System.String	path
System.Guid	action
System.String	interactions
System.String	groups

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

AddBinding(InputActionMap, String, String, String, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputActionMap actionMap, string path, string interactions = null, string groups = null, string action = null)

Parameters

Type	Name	Description
InputActionMap	actionMap
System.String	path
System.String	interactions
System.String	groups
System.String	action

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

AddBinding(InputActionMap, String, InputAction, String, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputActionMap actionMap, string path, InputAction action, string interactions = null, string groups = null)

Parameters

Type	Name	Description
InputActionMap	actionMap
System.String	path
InputAction	action
System.String	interactions
System.String	groups

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

AddBinding(InputActionMap, InputBinding)

Declaration

public static InputActionSetupExtensions.BindingSyntax AddBinding(this InputActionMap actionMap, InputBinding binding)

Parameters

Type	Name	Description
InputActionMap	actionMap
InputBinding	binding

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

AddCompositeBinding(InputAction, String, String)

Declaration

public static InputActionSetupExtensions.CompositeSyntax AddCompositeBinding(this InputAction action, string composite, string interactions = null)

Parameters

Type	Name	Description
InputAction	action
System.String	composite
System.String	interactions

Returns

Type	Description
InputActionSetupExtensions.CompositeSyntax

AddControlScheme(InputActionAsset, String)

Add a new control scheme to the given asset.

Declaration

public static InputActionSetupExtensions.ControlSchemeSyntax AddControlScheme(this InputActionAsset asset, string name)

Parameters

Type	Name	Description
InputActionAsset	asset	Asset to add the control scheme to.
System.String	name	Name to give to the control scheme. Must be unique within the control schemes of the asset. Also used as default name of bindingGroup associated with the control scheme.

Returns

Type	Description
InputActionSetupExtensions.ControlSchemeSyntax	Syntax to allow providing additional configuration for the newly added control scheme.

Exceptions

Type	Condition
System.ArgumentNullException	asset is null or name is null or empty.

ChangeBinding(InputAction, Int32)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBinding(this InputAction action, int index)

Parameters

Type	Name	Description
InputAction	action
System.Int32	index

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

ChangeBinding(InputAction, InputBinding)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBinding(this InputAction action, InputBinding match)

Parameters

Type	Name	Description
InputAction	action
InputBinding	match

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

ChangeBindingWithGroup(InputAction, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBindingWithGroup(this InputAction action, string group)

Parameters

Type	Name	Description
InputAction	action
System.String	group

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

ChangeBindingWithId(InputAction, Guid)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBindingWithId(this InputAction action, Guid id)

Parameters

Type	Name	Description
InputAction	action
System.Guid	id

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

ChangeBindingWithId(InputAction, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBindingWithId(this InputAction action, string id)

Parameters

Type	Name	Description
InputAction	action
System.String	id

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

ChangeBindingWithPath(InputAction, String)

Declaration

public static InputActionSetupExtensions.BindingSyntax ChangeBindingWithPath(this InputAction action, string path)

Parameters

Type	Name	Description
InputAction	action
System.String	path

Returns

Type	Description
InputActionSetupExtensions.BindingSyntax

OrWithOptionalDevice(InputControlScheme, String)

Declaration

public static InputControlScheme OrWithOptionalDevice(this InputControlScheme scheme, string controlPath)

Parameters

Type	Name	Description
InputControlScheme	scheme
System.String	controlPath

Returns

Type	Description
InputControlScheme

OrWithRequiredDevice(InputControlScheme, String)

Declaration

public static InputControlScheme OrWithRequiredDevice(this InputControlScheme scheme, string controlPath)

Parameters

Type	Name	Description
InputControlScheme	scheme
System.String	controlPath

Returns

Type	Description
InputControlScheme

Rename(InputAction, String)

Rename an existing action.

Declaration

public static void Rename(this InputAction action, string newName)

Parameters

Type	Name	Description
InputAction	action	Action to assign a new name to. Can be singleton action or action that is part of a map.
System.String	newName	New name to assign to action. Cannot be empty.

Exceptions

Type	Condition
System.ArgumentNullException	action is null or newName is null or empty.
System.InvalidOperationException	actionMap of action already contains an action called newName.

WithBindingGroup(InputControlScheme, String)

Declaration

public static InputControlScheme WithBindingGroup(this InputControlScheme scheme, string bindingGroup)

Parameters

Type	Name	Description
InputControlScheme	scheme
System.String	bindingGroup

Returns

Type	Description
InputControlScheme

WithOptionalDevice(InputControlScheme, String)

Declaration

public static InputControlScheme WithOptionalDevice(this InputControlScheme scheme, string controlPath)

Parameters

Type	Name	Description
InputControlScheme	scheme
System.String	controlPath

Returns

Type	Description
InputControlScheme

WithRequiredDevice(InputControlScheme, String)

Declaration

public static InputControlScheme WithRequiredDevice(this InputControlScheme scheme, string controlPath)

Parameters

Type	Name	Description
InputControlScheme	scheme
System.String	controlPath

Returns

Type	Description
InputControlScheme