Input Action

Like what your seeing?
Consider supporting us as a GitHub Sponsor and get instant access to all our Unity assets, exclusive tools and assets, escalated support and issue tracking and our gratitude.

These articles are made possible by our GitHub Sponsors ... become a sponsor today!
Introduction
public class InputAction : GameEvent<InputActionData>
Represents a Steam Input Action such as defined in your games IGA file.
These must be created as part of your Steam Settings object .
Fields and Attributes
Type
Name
Comment
InputActionType
type
The type of action (Analog or Digital)
string
actionName
The name of the action as it appears in the IGA file
InputAnalogActionHandle_t
AnalogHandle
The native Steam API handle if this is a analog handle and has been resolved.
InputDigitalActionHandle_t
DigitalHandle
The native Steam API handle if this is a digital handle and has been resolved.
Methods
Get Data
public InputActionData this[InputHandle_t controller];
This returns the current cashed state for this action and for this controller, this does not update the state with the latest data from Steam it simply returns the last updated state. Typically you would have a behaviour poll all relivent actions at the start of an update and let various behaviours simply read the last known state for the actions they are interested in.
Example:
public class PlayerController : MonoBehaviour
{
    Steamworks.InputHandle_t controller;
    public InputAction someAction;
    
    // ...
    
    private void Start()
    {
        controller = HeathenEngineering.SteamworksIntegration.API.Input.Client.ConnectedControllers[0];
    }
    
    //...
    
    private void Update()
    {
        SteamSettings.Client.UpdateAllActions(controller);
        
        var actionData = someAction[controller];
        if(actionData.active)
            Debug.Log("Engaged: " + actionData.state);
    }
}
Once you have a script updating the status of your actions other behaviours can simply read that most recent state;
public class SomeOtherBehaviour : MonoBehaviour
{
    Steamworks.InputHandle_t controller;
    public InputAction otherAction;
    
    // ...
    
    private void Start()
    {
        controller = HeathenEngineering.SteamworksIntegration.API.Input.Client.ConnectedControllers[0];
    }
    
    // ...
    
    private void Update()
    {
        var actionData = otherAction[controller];
        if(actionData.active)
            Debug.Log("Engaged: " + actionData.state);
    }
}
Update Status
public void UpdateStatus(InputHandle_t controller);
Call this to update the state of the action for the indicated controller.
Example:
var controller = Input.Client.ConnectedControllers[0];
// ...
testAction.UpdateStatus(controller);
You can optionally call this for all actions at once via the Steam Settings object
var controller = Input.Client.ConnectedControllers[0];
// ...
SteamSettings.Client.UpdateAllActions(controller);
Get Input Glyphs
public Texture2D[] GetInputGlyphs(InputHandle_t controller, InputActionSet set);
public Texture2D[] GetInputGlyphs(InputHandle_t controller, InputActionSetLayer set);
public Texture2D[] GetInputGlyphs(InputHandle_t controller, InputactionSetHandle_t set);
This returns the set of textures related to the action for the given controller and action set. For example if this action exists on the indicated set and is mapped to the B button and Right Trigger then the B button texture and RT texture will be returned. 
The images for these can be configured in your app.
Examples:
var images = action.GetInputGlyphs(controller, actionSet);
// ...
rawImage.Texture = images[0];
Get Input Names
public string[] GetInputNames(InputHandle_t controller, InputActionSet set);
public string[] GetInputNames(InputHandle_t controller, InputActionSetLayer set);
public string[] GetInputNames(InputHandle_t controller, InputactionSetHandle_t set);
This returns the set of names related to the action for the given controller and action set. For example if this action exists on the indicated set and is mapped to B and Right Trigger then the string "B Button" and "Right Trigger" will be returned.
Examples:
var names = action.GetInputNames(controller, actionSet);
// ...
label.Text = names[0];
How To
Create
Input Actions are created as part of your Steam Settings object
Set Analog or Digital
Click the AI or DI buttton to change the type
AI represents "Analog Input"
DI represents "Digital Input"

Type	Name	Comment
InputActionType	type	The type of action (Analog or Digital)
string	actionName	The name of the action as it appears in the IGA file
InputAnalogActionHandle_t	AnalogHandle	The native Steam API handle if this is a analog handle and has been resolved.
InputDigitalActionHandle_t	DigitalHandle	The native Steam API handle if this is a digital handle and has been resolved.

Float Stat

Input Action Set

Last modified 26d ago