CHANGE: Refactor/clean up some APIs and add a batch of scripting API docs (#762).

Author: Rene Damm

Assets/Demo/OnScreenController/Prefabs.meta

@@ -4,6 +4,7 @@
 using UnityEngine.InputSystem.Utilities;
 using UnityEngine;
 using UnityEngine.InputSystem.Layouts;
+using UnityEngine.InputSystem.LowLevel;
 
 public struct MyDeviceState : IInputStateTypeInfo
 {
@@ -13,14 +14,10 @@ public struct MyDeviceState : IInputStateTypeInfo
     [InputControl(layout = "Axis")]
     public float axis1;
 
-    public FourCC format
-    {
-        get { return new FourCC('M', 'Y', 'D', 'V'); }
-    }
+    public FourCC format => new FourCC('M', 'Y', 'D', 'V');
 }
 
 [InputControlLayout(stateType = typeof(MyDeviceState))]
-//[InputPlugin]
 public class MyDevice : InputDevice, IInputUpdateCallbackReceiver
 {
     public ButtonControl button1 { get; private set; }
@@ -33,16 +30,13 @@ protected override void FinishSetup()
         base.FinishSetup();
     }
 
-    public void OnUpdate(InputUpdateType updateType)
+    public void OnUpdate()
     {
-        if (updateType == InputUpdateType.Dynamic)
-        {
-            var isButton1Pressed = Time.frameCount % 100 == 0;
-            if (isButton1Pressed)
-                InputSystem.QueueStateEvent(this, new MyDeviceState {buttons = 1});
-            else
-                InputSystem.QueueStateEvent(this, new MyDeviceState());
-        }
+        var isButton1Pressed = Time.frameCount % 100 == 0;
+        if (isButton1Pressed)
+            InputSystem.QueueStateEvent(this, new MyDeviceState {buttons = 1});
+        else
+            InputSystem.QueueStateEvent(this, new MyDeviceState());
     }
 
     public static void Initialize()

Assets/Demo/SimpleDemo/SimpleController_UsingActionEventQueue.cs

@@ -4,6 +4,7 @@
 using UnityEngine.InputSystem;
 using UnityEngine.InputSystem.Controls;
 using UnityEngine.InputSystem.Layouts;
+using UnityEngine.InputSystem.LowLevel;
 using UnityEngine.InputSystem.Utilities;
 using UnityEngine.InputSystem.Steam;
 #if UNITY_EDITOR

Assets/Demo/SimpleDemo/SimpleController_UsingActionEventQueue.cs.meta

@@ -1,5 +1,6 @@
 using UnityEngine;
 using UnityEngine.InputSystem;
+using UnityEngine.InputSystem.LowLevel;
 using UnityEngine.UI;
 
 ////FIXME: will not work properly when there are multiple keyboards

Assets/Demo/SimpleDevice.cs

@@ -0,0 +1,4 @@
+{
+  "displayName": "On-Screen Controls Sample",
+  "description": "Demonstrates a simple setup for an on-screen joystick."
+} 

Assets/Demo/SteamController/SteamDemoController.cs

@@ -0,0 +1,4 @@
+{
+  "displayName": "Visualizers",
+  "description": "Several example visualizations of input controls/devices and input actions."
+} 

Assets/QA/Input_Test/IMETest.cs

@@ -1,5 +1,5 @@
 using UnityEngine;
-using UnityEngine.InputSystem.PlayerInput;
+using UnityEngine.InputSystem;
 using UnityEngine.SceneManagement;
 
 public class TankMovement : MonoBehaviour

Assets/Demo/OnScreenController.meta renamed to Assets/Samples/OnScreenControls.meta

@@ -1,5 +1,5 @@
 using UnityEngine;
-using UnityEngine.InputSystem.PlayerInput;
+using UnityEngine.InputSystem;
 using UnityEngine.UI;
 
 

Assets/Samples/OnScreenControls/.sample.json

@@ -7,6 +7,7 @@
 using Mono.Cecil;
 using UnityEditor.PackageManager.DocumentationTools.UI;
 using UnityEngine.InputSystem;
+using UnityEngine.InputSystem.LowLevel;
 using HtmlAgilityPack;
 
 class APIVerificationTests
@@ -37,9 +38,9 @@ private bool IsTypeWhichCanHavePublicFields(TypeReference type)
 
         if (
             // These have fields popuplated by reflection in the Input System
-            type.FullName == typeof(UnityEngine.InputSystem.InputProcessor).FullName ||
-            type.FullName == typeof(UnityEngine.InputSystem.InputControl).FullName ||
-            type.FullName == typeof(UnityEngine.InputSystem.InputBindingComposite).FullName
+            type.FullName == typeof(InputProcessor).FullName ||
+            type.FullName == typeof(InputControl).FullName ||
+            type.FullName == typeof(InputBindingComposite).FullName
         )
             return true;
 
@@ -52,15 +53,15 @@ private bool IsTypeWhichCanHavePublicFields(TypeReference type)
 
             if (
                 // Interactions have fields populated by reflection in the Input System
-                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(UnityEngine.InputSystem.IInputInteraction).FullName) ||
+                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(IInputInteraction).FullName) ||
 
                 // Input state structures use fields for the memory layout and construct Input Controls from the fields.
-                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(UnityEngine.InputSystem.IInputStateTypeInfo).FullName) ||
+                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(IInputStateTypeInfo).FullName) ||
 
                 // These use fields for the explicit memory layout, and have a member for the base type. If we exposed that via a property,
                 // base type values could not be written individually.
-                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(UnityEngine.InputSystem.LowLevel.IInputDeviceCommandInfo).FullName) ||
-                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(UnityEngine.InputSystem.LowLevel.IInputEventTypeInfo).FullName) ||
+                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(IInputDeviceCommandInfo).FullName) ||
+                resolved.Interfaces.Any(i => i.InterfaceType.FullName == typeof(IInputEventTypeInfo).FullName) ||
 
                 // serializable types may depend on the field names to match serialized data (eg. Json)
                 resolved.Attributes.HasFlag(TypeAttributes.Serializable)
@@ -77,7 +78,7 @@ private bool IsTypeWhichCanHavePublicFields(TypeReference type)
 
     private IEnumerable<TypeDefinition> GetInputSystemPublicTypes()
     {
-        var codeBase = typeof(UnityEngine.InputSystem.InputSystem).Assembly.CodeBase;
+        var codeBase = typeof(InputSystem).Assembly.CodeBase;
         var uri = new UriBuilder(codeBase);
         var path = Uri.UnescapeDataString(uri.Path);
         var asmDef = AssemblyDefinition.ReadAssembly(path);
@@ -232,12 +233,14 @@ bool IgnoreTypeForDocs(TypeDefinition type)
 #if UNITY_EDITOR_WIN
             type.FullName == typeof(UnityEngine.InputSystem.XInput.XInputControllerWindows).FullName ||
 #endif
+#if UNITY_ENABLE_STEAM_CONTROLLER_SUPPORT
             type.FullName == typeof(UnityEngine.InputSystem.Steam.ISteamControllerAPI).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.Steam.SteamController).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.Steam.SteamDigitalActionData).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.Steam.SteamAnalogActionData).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.Steam.SteamHandle<>).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.Steam.Editor.SteamIGAConverter).FullName ||
+#endif
             type.FullName == typeof(UnityEngine.InputSystem.PS4.PS4TouchControl).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.PS4.DualShockGamepadPS4).FullName ||
             type.FullName == typeof(UnityEngine.InputSystem.PS4.MoveControllerPS4).FullName ||

Assets/Demo/OnScreenController/Prefabs/Button.prefab renamed to Assets/Samples/OnScreenControls/Button.prefab

@@ -1392,7 +1392,7 @@ public void Process(ref InputInteractionContext context)
         {
             var actuated = context.ControlIsActuated();
             if (!actuated && m_WaitingForRelease)
-                context.PerformedAndGoBackToWaiting();
+                context.Performed();
             else if (actuated)
                 m_WaitingForRelease = true;
         }
@@ -2592,7 +2592,7 @@ public void Actions_CanAddInteractionsToActions()
 
         var gamepad = InputSystem.AddDevice<Gamepad>();
 
-        InputSystem.RegisterControlProcessor<ConstantVector2TestProcessor>();
+        InputSystem.RegisterProcessor<ConstantVector2TestProcessor>();
         var action = new InputAction(interactions: "Tap(duration=0.123)");
         action.AddBinding("<Gamepad>/buttonSouth");
         action.Enable();
@@ -2619,7 +2619,7 @@ public void Actions_CanAddProcessorsToActions()
     {
         var gamepad = InputSystem.AddDevice<Gamepad>();
 
-        InputSystem.RegisterControlProcessor<ConstantVector2TestProcessor>();
+        InputSystem.RegisterProcessor<ConstantVector2TestProcessor>();
         var action = new InputAction(processors: "ConstantVector2Test");
         action.AddBinding("<Gamepad>/leftStick");
         action.Enable();
@@ -2645,7 +2645,7 @@ public void Actions_IncompatibleProcessorIsIgnored()
     {
         var gamepad = InputSystem.AddDevice<Gamepad>();
 
-        InputSystem.RegisterControlProcessor<ConstantVector2TestProcessor>();
+        InputSystem.RegisterProcessor<ConstantVector2TestProcessor>();
         var action = new InputAction(processors: "ConstantVector2Test");
         action.AddBinding("<Gamepad>/leftStick/x");
         action.Enable();
@@ -2681,7 +2681,7 @@ public void Actions_CanAddProcessorsToBindings()
     {
         var gamepad = InputSystem.AddDevice<Gamepad>();
 
-        InputSystem.RegisterControlProcessor<ConstantVector2TestProcessor>();
+        InputSystem.RegisterProcessor<ConstantVector2TestProcessor>();
         var action = new InputAction();
         action.AddBinding("<Gamepad>/leftStick").WithProcessor<ConstantVector2TestProcessor>();
         action.Enable();
@@ -4669,7 +4669,7 @@ private class LogInteraction : IInputInteraction
         public void Process(ref InputInteractionContext context)
         {
             Debug.LogAssertion("LogInteraction.Process");
-            context.PerformedAndGoBackToWaiting();
+            context.Performed();
         }
 
         public void Reset()