playtest-unity/playtest/Library/PackageCache/com.unity.ugui@1.0.0/Documentation~/script-StandaloneInputModul...

50 lines
2.9 KiB
Markdown

# Standalone Input Module
The module is designed to work as you would expect a controller / mouse input to work. Events for button presses, dragging, and similar are sent in response to input.
The module sends pointer events to components as a mouse / input device is moved around, and uses the [Graphics Raycaster](script-GraphicRaycaster.md) and [Physics Raycaster](script-PhysicsRaycaster.md) to calculate which element is currently pointed at by a given pointer device. You can configure these raycasters to detect or ignore parts of your Scene, to suit your requirements.
The module sends move events and submit / cancel events in response to Input tracked via the [Input](https://docs.unity3d.com/Manual/class-InputManager.html) window. This works for both keyboard and controller input. The tracked axis and keys can be configured in the module's inspector.
## Properties
|**_Property:_** |**_Function:_** |
|:---|:---|
|__Horizontal Axis__ | Type the desired manager name for the horizontal axis button. |
|__Vertical Axis__ | Type the desired manager name for the vertical axis. |
|__Submit Button__ | Type the desired manager name for the Submit button. |
|__Cancel Button__ | Type the desired manager name for the Cancel button. |
|__Input Actions Per Second__ | Number of keyboard/controller inputs allowed per second. |
|__Repeat Delay__ | Delay in seconds before the input actions per second repeat rate takes effect. |
|__Force Module Active__ | Enable this property to force this __Standalone Input Module__ to be active. |
## Details
The module uses:
- Vertical / Horizontal axis for keyboard and controller navigation
- Submit / Cancel button for sending submit and cancel events
- Has a timeout between events to only allow a maximum number of events a second.
The flow for the module is as follows
- Send a Move event to the selected object if a valid axis from the Input window is entered
- Send a submit or cancel event to the selected object if a submit or cancel button is pressed
- Process Mouse input
- If it is a new press
- Send PointerEnter event (sent to every object up the hierarchy that can handle it)
- Send PointerPress event
- Cache the drag handler (first element in the hierarchy that can handle it)
- Send BeginDrag event to the drag handler
- Set the 'Pressed' object as Selected in the event system
- If this is a continuing press
- Process movment
- Send DragEvent to the cached drag handler
- Handle PointerEnter and PointerExit events if touch moves between objects
- If this is a release
- Send PointerUp event to the object that received the PointerPress
- If the current hover object is the same as the PointerPress object send a PointerClick event
- Send a Drop event if there was a drag handler cached
- Send a EndDrag event to the cached drag handler
- Process scroll wheel events