Class InputTestFixture

A test fixture for writing tests that use the input system. Can be derived from or simply instantiated from another test fixture.

Inheritance

System.Object

InputTestFixture

Namespace: UnityEngine.InputSystem

Syntax

public class InputTestFixture

Remarks

The fixture will put the input system into a known state where it has only the built-in set of basic layouts and no devices. The state of the system before starting a test is recorded and restored when the test finishes.

Examples

public class MyInputTests : InputTestFixture
{
    public override void Setup()
    {
        base.Setup();

        InputSystem.RegisterLayout<MyDevice>();
    }

    [Test]
    public void CanCreateMyDevice()
    {
        InputSystem.AddDevice<MyDevice>();
        Assert.That(InputSystem.devices, Has.Exactly(1).TypeOf<MyDevice>());
    }
}

Properties

runtime

The input runtime used during testing.

Declaration

public InputTestRuntime runtime { get; }

Property Value

Type	Description
InputTestRuntime

Methods

AssertButtonPress<TState>(InputDevice, TState, ButtonControl[])

Declaration

public static void AssertButtonPress<TState>(InputDevice device, TState state, params ButtonControl[] buttons)
    where TState : struct, IInputStateTypeInfo

Parameters

Type	Name	Description
InputDevice	device
TState	state
ButtonControl[]	buttons

Type Parameters

Name	Description
TState

Canceled(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Canceled(InputAction action, InputControl control = null)

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Canceled<TInteraction>(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Canceled<TInteraction>(InputAction action, InputControl control = null)
    where TInteraction : IInputInteraction

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Type Parameters

Name	Description
TInteraction

Performed(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Performed(InputAction action, InputControl control = null)

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Performed<TInteraction>(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Performed<TInteraction>(InputAction action, InputControl control = null)
    where TInteraction : IInputInteraction

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Type Parameters

Name	Description
TInteraction

Press(ButtonControl, Double, Double)

Declaration

public void Press(ButtonControl button, double absoluteTime = -1, double timeOffset = 0)

Parameters

Type	Name	Description
ButtonControl	button
System.Double	absoluteTime
System.Double	timeOffset

PressAndRelease(ButtonControl, Double, Double)

Declaration

public void PressAndRelease(ButtonControl button, double absoluteTime = -1, double timeOffset = 0)

Parameters

Type	Name	Description
ButtonControl	button
System.Double	absoluteTime
System.Double	timeOffset

Release(ButtonControl, Double, Double)

Declaration

public void Release(ButtonControl button, double absoluteTime = -1, double timeOffset = 0)

Parameters

Type	Name	Description
ButtonControl	button
System.Double	absoluteTime
System.Double	timeOffset

Set<TValue>(InputControl<TValue>, TValue, Double, Double)

Set the control to the given value by sending a state event with the value to the control's device.

Declaration

public void Set<TValue>(InputControl<TValue> control, TValue state, double absoluteTime = -1, double timeOffset = 0)
    where TValue : struct

Parameters

Type	Name	Description
InputControl<TValue>	control	An input control on a device that has been added to the system.
TValue	state	New value for the input control.
System.Double	absoluteTime
System.Double	timeOffset

Type Parameters

Name	Description
TValue	Value type of the given control.

Examples

var gamepad = InputSystem.AddDevice<Gamepad>();
Set(gamepad.leftButton, 1);

Setup()

Put InputSystem into a known state where it only has a basic set of layouts and does not have any input devices.

Declaration

public virtual void Setup()

Remarks

If you derive your own test fixture directly from InputTestFixture, this method will automatically be called. If you embed InputTestFixture into your fixture, you have to explicitly call this method yourself.

Started(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Started(InputAction action, InputControl control = null)

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Started<TInteraction>(InputAction, InputControl)

Declaration

public InputTestFixture.ActionConstraint Started<TInteraction>(InputAction action, InputControl control = null)
    where TInteraction : IInputInteraction

Parameters

Type	Name	Description
InputAction	action
InputControl	control

Returns

Type	Description
InputTestFixture.ActionConstraint

Type Parameters

Name	Description
TInteraction

TearDown()

Restore the state of the input system it had when the test was started.

Declaration

public virtual void TearDown()

Trigger(InputAction)

Perform the input action without having to know what it is bound to.

Declaration

public void Trigger(InputAction action)

Parameters

Type	Name	Description
InputAction	action	An input action that is currently enabled and has controls it is bound to.

Remarks

Blindly triggering an action requires making a few assumptions. Actions are not built to be able to trigger without any input. This means that this method has to generate input on a control that the action is bound to.

Note that this method has no understanding of the interactions that may be present on the action and thus does not know how they may affect the triggering of the action.

Trigger<TValue>(InputAction, InputControl<TValue>, TValue)

Declaration

public void Trigger<TValue>(InputAction action, InputControl<TValue> control, TValue value)
    where TValue : struct

Parameters

Type	Name	Description
InputAction	action
InputControl<TValue>	control
TValue	value

Type Parameters

Name	Description
TValue