Version: 2017.3

Input

class in UnityEngine

Cambiar al Manual

Descripción

Interfaz al sistema de Input (entrada).

Use this class to read the axes set up in the Input Manager, and to access multi-touch/accelerometer data on mobile devices.

To read an axis use Input.GetAxis with one of the following default axes: "Horizontal" and "Vertical" are mapped to joystick, A, W, S, D and the arrow keys. "Mouse X" and "Mouse Y" are mapped to the mouse delta. "Fire1", "Fire2" "Fire3" are mapped to Ctrl, Alt, Cmd keys and three mouse or joystick buttons. New input axes can be added in the Input Manager.

If you are using input for any kind of movement behaviour use Input.GetAxis. It gives you smoothed and configurable input that can be mapped to keyboard, joystick or mouse. Use Input.GetButton for action like events only. Don't use it for movement, Input.GetAxis will make the script code smaller and simpler.

Tenga en cuenta también que los flags (indicadores) de input (entrada) no se re-establecen hasta "Update()", por lo que se sugiere hacer todas las llamadas de input (entrada) en el bucle de Update.

Dispositivos Móviles:

iOS and Android devices are capable of tracking multiple fingers touching the screen simultaneously. You can access data on the status of each finger touching screen during the last frame by accessing the Input.touches property array.

As a device moves, its accelerometer hardware reports linear acceleration changes along the three primary axes in three-dimensional space. You can use this data to detect both the current orientation of the device (relative to the ground) and any immediate changes to that orientation.

Acceleration along each axis is reported directly by the hardware as G-force values. A value of 1.0 represents a load of about +1g along a given axis while a value of -1.0 represents -1g. If you hold the device upright (with the home button at the bottom) in front of you, the X axis is positive along the right, the Y axis is positive directly up, and the Z axis is positive pointing toward you.

You can read the Input.acceleration property to get the accelerometer reading. You can also use the Input.deviceOrientation property to get a discrete evaluation of the device's orientation in three-dimensional space. Detecting a change in orientation can be useful if you want to create game behaviors when the user rotates the device to hold it differently.

Note that the accelerometer hardware can be polled more than once per frame. To access all accelerometer samples since the last frame, you can read the Input.accelerationEvents property array. This can be useful when reconstructing player motions, feeding acceleration data into a predictor, or implementing other precise motion analysis.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public void Update() { if (Input.GetButtonDown("Fire1")) { Debug.Log(Input.mousePosition); } } }

Note: This component relates to legacy methods for drawing UI textures and images to the screen. You should use Unity’s up-to-date UI system instead. This is also unrelated to the IMGUI system.

Variables Estáticas

accelerationÚltima aceleración lineal medida de un dispositivo en el espacio tridimensional. (Read Only)
accelerationEventCountDevuelve la lista de mediciones de aceleración que ocurrieron durante el último frame.
accelerationEventsDevuelve la lista de mediciones de aceleración que ocurrieron durante el último frame. (Read Only) (asigna variables temporales).
anyKeySe mantiene presionada alguna tecla o botón del mouse? (Read Only)
anyKeyDownDevuelve true el primer frame en el que el usuario toca cualquier tecla o botón del mouse. (Read Only)
backButtonLeavesAppDebería el botón Back salirse de la aplicación?Solo se puede utilizar en Android, Windows Phone o Windows Tablets.
compassPropiedad para acceder a la brújula (dispositivos portátiles solamente). (Read Only)
compensateSensorsEsta propiedad controla si los sensores de input deben ser compensados por la orientación de la pantalla.
compositionCursorPosLa posición actual de entrada de texto utilizada por los IME para abrir ventanas.
compositionStringEl string de composición actual IME siendo ingresado por el usuario.
deviceOrientationOrientación física del dispositivo según lo informado por OS. (Read Only)
gyroDevuelve el giroscopio por defecto.
imeCompositionModeControla la habilitación y deshabilitación de la composición de entrada de IME.
imeIsSelectedEl usuario tiene una fuente de entrada de teclado IME seleccionada?
inputStringDevuelve el input del teclado ingresado este frame. (Read Only)
locationPropiedad para acceder a la ubicación del dispositivo (dispositivos portátiles solamente). (Read Only)
mousePositionLa posición actual del mouse en coordenadas de pixel. (Read Only)
mousePresentIndica si un dispositivo mouse ha sido detectado.
mouseScrollDeltaEl delta actual del desplazamiento del mouse. (Read Only)
multiTouchEnabledPropiedad que indica si el sistema maneja múltiples toques.
simulateMouseWithTouchesHabilita/Desactiva la simulación de mouse con toques. Por defecto, esta es la opción habilitada.
stylusTouchSupportedDevuelve true cuando el Stylus Touch es soportado por un dispositivo o plataforma.
touchCountCantidad de toques. Garantiza que no cambia a través del frame. (Read Only)
touchesDevuelve la lista de objetos que representan el estado de todos los toques durante el último frame. (Read Only) (asigna variables temporales).
touchPressureSupportedValor Bool que permite a los usuarios comprobar si la presión táctil es compatible.
touchSupportedDevuelve si el dispositivo en el que se está ejecutando la aplicación en curso admite el input (entrada) táctil.

Funciones Estáticas

GetAccelerationEventDevuelve una medida de aceleración específica que ocurre durante el último frame. (No asigna variables temporales).
GetAxisDevuelve el valor del eje virtual identificado por axisName.
GetAxisRawDevuelve un valor del eje virtual identificado por axisName sin un filtro de suavizado aplicado.
GetButtonDevuelve true mientras el botón virtual identificado por buttonName se mantiene presionado.
GetButtonDownDevuelve true durante el frame que usuario presiono el botón virtual identificado por buttonName.
GetButtonUpDevuelve true el primer frame que el usuario soltó el botón virtual identificado por buttonName.
GetJoystickNamesDevuelve un arreglo de strings describiendo los joysticks conectados.
GetKeyDevuelve true mientras el usuario mantiene oprimido la teclada identificada por name. Piense en el fuego automático.
GetKeyDownDevuelve true durante el frame que el usuario empieza a presionar la tecla identificada por name.
GetKeyUpDevuelve true durante el frame que el usuario soltó la tecla identificada por name.
GetMouseButtonDevuelve si se mantiene oprimido el botón del mouse.
GetMouseButtonDownDevuelve true durante el frame que el usuario presiono el botón del mouse dado.
GetMouseButtonUpDevuelve true durante el frame que el usuario soltó el botón del mouse dado.
GetTouchDevuelve el objeto representando el estatus de un tacto especifico. (No asigna variables temporales).
IsJoystickPreconfiguredDetermine si un modelo joystick en particular ha sido pre-configurado por Unity. (Linux-solamente).
ResetInputAxesRe-inicia todo el input. Después ResetInputAxes todos los ejes devueltos a 0 y todos los botones devuelven a 0 para un frame.