Close
    Search Search

    UserInputService

    El UserInputService class, agregada en la versión 0.80, hereda de Instance. No se puede crear una instancia.



    Contenido

    • Propiedades 1
      • 1.1 bool Acelerómetro habilitado [ReadOnly] [NotReplicated]
      • 1.2 Vector2 BottomBarSize [Oculto] [Solo lectura] [NotReplicated]
      • 1.3 bool GamepadEnabled [ReadOnly] [NotReplicated]
      • 1.4 bool GazeSelectionEnabled [Oculto] [NotReplicated]
      • 1.5 bool Giroscopio habilitado [ReadOnly] [NotReplicated]
      • 1.6 bool KeyboardEnabled [ReadOnly] [NotReplicated]
      • 1.7 bool LegacyInputEventsEnabled [Oculto]
      • 1.8 bool ModalEnabled
      • 1.9 Comportamiento del ratón MouseBehavior
      • 1.10 flotar MouseDeltaSensibilidad [NotReplicated]
      • 1.11 bool MouseEnabled [ReadOnly] [NotReplicated]
      • 1.12 bool MouseIconEnabled
      • 1.13 Vector2 NavBarSize [Oculto] [Solo lectura] [NotReplicated]
      • 1.14 doble OnScreenKeyboardAnimationDuration [Oculto] [Solo lectura] [NotReplicated]
      • 1.15 Vector2 OnScreenKeyboardPosition [ReadOnly] [NotReplicated]
      • 1.16 Vector2 OnScreenKeyboardSize [ReadOnly] [NotReplicated]
      • 1.17 bool OnScreenKeyboardVisible [ReadOnly] [NotReplicated]
      • 1.18 OverrideMouseIconBehavior OverrideMouseIconBehavior [Oculto]
      • 1.19 Vector2 RightBarSize [Oculto] [Solo lectura] [NotReplicated]
      • 1.20 Vector2 StatusBarSize [Oculto] [Solo lectura] [NotReplicated]
      • 1.21 bool TouchEnabled [ReadOnly] [NotReplicated]
      • 1.22 CFrame UserHeadCFrame [ReadOnly] [NotReplicated] [Obsoleto]
      • 1.23 bool VREnabled [ReadOnly] [NotReplicated]
    • 2 Funciones
      • 2.1 bool Controles para juegos(UserInputType gamepadNum, KeyCode gamepadKeyCode)
      • 2.2 Matriz GetConnectedGamepads()
      • 2.3 InputObject GetDeviceAcceleration()
      • 2.4 InputObject GetDeviceGravity()
      • 2.5 Tupla GetDeviceRotation()
      • 2.6 DeviceType GetDeviceType()
      • 2.7 Cuadro de texto GetFocusedTextBox()
      • 2.8 bool GetGamepadConnected(UserInputType gamepadNum)
      • 2.9 Matriz GetGamepadState(UserInputType gamepadNum)
      • 2.10 Matriz GetKeysPressed()
      • 2.11 UserInputType GetLastInputType()
      • 2.12 Matriz GetMouseButtonsPressed()
      • 2.13 Vector2 GetMouseDelta()
      • 2.14 Vector2 GetMouseLocation()
      • 2.15 Matriz GetNavigationGamepads()
      • 2.16 Plataforma GetPlatform()
      • 2.17 cuerda GetStringForKeyCode(KeyCode keyCode)
      • 2.18 Matriz GetSupportedGamepadKeyCodes(UserInputType gamepadNum)
      • 2.19 CFrame GetUserCFrame(Tipo UserCFrame)
      • 2.20 bool IsGamepadButtonDown(UserInputType gamepadNum, KeyCode gamepadKeyCode)
      • 2.21 bool IsKeyDown(KeyCode keyCode)
      • 2.22 bool IsMouseButtonPressed(UserInputType mouseButton)
      • 2.23 bool IsNavigationGamepad(UserInputType gamepadEnum)
      • 2.24 nulo RecenterUserHeadCFrame()
      • 2.25 nulo SendAppUISizes(Vector2 statusBarSize, Vector2 navBarSize, Vector2 bottomBarSize, Vector2 rightBarSize)
      • 2.26 nulo SetNavigationGamepad(UserInputType gamepadEnum, bool habilitado)
    • 3 Eventos
      • 3.1  DeviceAccelerationChanged(Aceleración InputObject)
      • 3.2  DeviceGravityChanged(Gravedad de InputObject)
      • 3.3  DeviceRotationChanged(Rotación de InputObject, CFrame cframe)
      • 3.4  Mando conectado(UserInputType gamepadNum)
      • 3.5  Gamepad Desconectado(UserInputType gamepadNum)
      • 3.6  Entrada Comenzó(Entrada InputObject, bool gameProcessedEvent)
      • 3.7  InputChanged(Entrada InputObject, bool gameProcessedEvent)
      • 3.8  InputEnded(Entrada InputObject, bool gameProcessedEvent)
      • 3.9  JumpRequest()
      • 3.10  LastInputTypeChanged(UserInputType lastInputType)
      • 3.11  PunteroAcción(rueda flotante, bandeja Vector2, pellizco flotante, juego boolProcessedEvent)
      • 3.12  StatusBarTapped(Posición Vector2)
      • 3.13  TextBoxFocusReleased(TextBox textboxReleased)
      • 3.14  TextBoxFocused(TextBox textboxFocused)
      • 3.15  TouchEnded(InputObject touch, bool gameProcessedEvent)
      • 3.16  TouchLongPress(Array touchPositions, estado UserInputState, bool gameProcessedEvent)
      • 3.17  TouchMoved(InputObject touch, bool gameProcessedEvent)
      • 3.18  TouchPan(Array touchPositions, Vector2 totalTranslation, Vector2 velocity, estado UserInputState, bool gameProcessedEvent)
      • 3.19  TouchPinch(Array touchPositions, escala flotante, velocidad flotante, estado UserInputState, bool gameProcessedEvent)
      • 3.20  TouchRotate(Array touchPositions, rotación flotante, velocidad flotante, estado UserInputState, bool gameProcessedEvent)
      • 3.21  TouchStarted(InputObject touch, bool gameProcessedEvent)
      • 3.22  TouchSwipe(SwipeDirection swipeDirection, int numberOfTouches, bool gameProcessedEvent)
      • 3.23  Toque Toque(Array touchPositions, bool gameProcessedEvent)
      • 3.24  TouchTapInWorld(Posición Vector2, bool procesadoByUI)
      • 3.25  UserCFrameChanged(Tipo de UserCFrame, valor de CFrame)
      • 3.26  WindowFocusReleased()
      • 3.27  WindowFocused()
    • Enlaces 4 externos

    Propiedades

    UserInputService bool Acelerómetro habilitado [ReadOnly] [NotReplicated]

    Devuelve verdadero si el dispositivo local tiene un acelerómetro, falso en caso contrario.



    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService Vector2 BottomBarSize [Oculto] [Solo lectura] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService bool GamepadEnabled [ReadOnly] [NotReplicated]

    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService bool GazeSelectionEnabled [Oculto] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService bool Giroscopio habilitado [ReadOnly] [NotReplicated]

    Devuelve verdadero si el dispositivo local tiene un giroscopio, falso en caso contrario.

    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService bool KeyboardEnabled [ReadOnly] [NotReplicated]

    Devuelve verdadero si el dispositivo local acepta la entrada del teclado, falso en caso contrario.


    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService bool LegacyInputEventsEnabled [Oculto]

    • Categoría: Comportamiento.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: puede guardar y cargar.

    UserInputService bool ModalEnabled

    Si se establece en verdadero, los controles móviles serán visibles en el dispositivo de un reproductor móvil. Falso de lo contrario.


    • Categoría: Comportamiento.
    • Serialización: no se puede cargar ni guardar.

    UserInputService MouseBehavior MouseBehavior

    • Categoría: Datos.
    • Serialización: puede guardar y cargar.

    UserInputService flotar MouseDeltaSensibilidad [NotReplicated]

    • Categoría: Datos.
    • Serialización: solo se puede cargar.

    UserInputService bool MouseEnabled [ReadOnly] [NotReplicated]

    Devuelve verdadero si el dispositivo local acepta la entrada del mouse, falso en caso contrario.

    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService bool MouseIconEnabled

    Si se establece en verdadero, el icono del mouse será visible. Falso de lo contrario.


    • Categoría: Datos.
    • Serialización: puede guardar y cargar.

    UserInputService Vector2 NavBarSize [Oculto] [Solo lectura] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService doble OnScreenKeyboardAnimationDuration [Oculto] [Solo lectura] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService Vector2 OnScreenKeyboardPosition [ReadOnly] [NotReplicated]

    • Categoría: Datos.
    • Serialización: no se puede cargar ni guardar.

    UserInputService Vector2 OnScreenKeyboardSize [ReadOnly] [NotReplicated]

    • Categoría: Datos.
    • Serialización: no se puede cargar ni guardar.

    UserInputService bool OnScreenKeyboardVisible [ReadOnly] [NotReplicated]

    • Categoría: Datos.
    • Serialización: no se puede cargar ni guardar.

    UserInputService OverrideMouseIconBehavior OverrideMouseIconBehavior [Oculto]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService Vector2 RightBarSize [Oculto] [Solo lectura] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService Vector2 StatusBarSize [Oculto] [Solo lectura] [NotReplicated]

    • Categoría: Datos.
    • Leer seguridad: RobloxScriptSecurity.
    • Seguridad de escritura: RobloxScriptSecurity.
    • Serialización: no se puede cargar ni guardar.

    UserInputService bool TouchEnabled [ReadOnly] [NotReplicated]

    Devuelve verdadero si el dispositivo local acepta la entrada táctil, falso en caso contrario.


    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    UserInputService CFrame UserHeadCFrame [ReadOnly] [NotReplicated] [Obsoleto]

    • Categoría: Datos.
    • Serialización: no se puede cargar ni guardar.

    UserInputService bool VREnabled [ReadOnly] [NotReplicated]

    Estén encendidos o no los cascos de realidad virtual.

    • Categoría: Datos.
    • Serialización: solo se puede guardar.

    Las funciones clave

    UserInputService bool Controles para juegos(UserInputType gamepadNum, KeyCode gamepadKeyCode)

    UserInputService Formación GetConnectedGamepads()

    UserInputService InputObject GetDeviceAcceleration()

    Devuelve un InputObject que describe la aceleración actual del dispositivo. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Accelerometer, y una posición que muestra la fuerza g en cada eje del dispositivo local. La propiedad delta describe la cantidad de rotación que ocurrió por última vez. Este evento solo se activa localmente.

    UserInputService InputObject GetDeviceGravity()

    Devuelve un InputObject que describe el vector de gravedad actual del dispositivo. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Accelerometer, y una posición que muestra la fuerza g en cada eje del dispositivo local. La propiedad delta describe la cantidad de rotación que ocurrió por última vez. Este evento solo se activa localmente.

    UserInputService Tupla GetDeviceRotation()

    Devuelve un InputObject y un Vector4 que describe el vector de rotación actual del dispositivo. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Gyroscope, y una posición que muestra la rotación total en cada eje del dispositivo local. La propiedad delta describe la cantidad de rotación que ocurrió por última vez. El Vector4 es la rotación de cuaternión actual del dispositivo en referencia a su marco de referencia predeterminado. Este evento solo se activa localmente.

    UserInputService Tipo de dispositivo GetDeviceType()

    • Seguridad: RobloxScriptSecurity.

    UserInputService Caja de texto GetFocusedTextBox()

    Devuelve el cuadro de texto en el que está enfocado el reproductor local.

    UserInputService bool GetGamepadConnected(UserInputType gamepadNum)

    UserInputService Formación GetGamepadState(UserInputType gamepadNum)

    UserInputService Formación GetKeysPressed()

    UserInputService UserInputType GetLastInputType()

    UserInputService Formación GetMouseButtonsPressed()

    UserInputService Vector2 GetMouseDelta()

    UserInputService Vector2 GetMouseLocation()

    UserInputService Formación GetNavigationGamepads()

    UserInputService Plataforma GetPlatform()

    • Seguridad: RobloxScriptSecurity.

    UserInputService cadena GetStringForKeyCode(KeyCode keyCode)

    UserInputService Formación GetSupportedGamepadKeyCodes(UserInputType gamepadNum)

    UserInputService CFrame GetUserCFrame(Tipo UserCFrame)

    UserInputService bool IsGamepadButtonDown(UserInputType gamepadNum, KeyCode gamepadKeyCode)

    UserInputService bool IsKeyDown(KeyCode keyCode)

    Devuelve verdadero si se presiona el KeyCode dado en el teclado del jugador. Falso de lo contrario.

    UserInputService bool IsMouseButtonPressed(UserInputType mouseButton)

    UserInputService bool IsNavigationGamepad(UserInputType gamepadEnum)

    UserInputService vacío RecenterUserHeadCFrame()

    UserInputService vacío SendAppUISizes(Vector2 statusBarSize, Vector2 navBarSize, Vector2 bottomBarSize, Vector2 rightBarSize)

    • Seguridad: RobloxScriptSecurity.

    UserInputService vacío SetNavigationGamepad(UserInputType gamepadEnum, bool habilitado)

    Eventos

    UserInputService DeviceAccelerationChanged(Aceleración InputObject)

    Se activa cuando un usuario mueve un dispositivo que tiene un acelerómetro. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Accelerometer, y una posición que muestra la fuerza g en cada eje del dispositivo local. Este evento solo se activa localmente.

    UserInputService DeviceGravityChanged(Gravedad de InputObject)

    Se dispara cuando la fuerza de la gravedad cambia en un dispositivo que tiene un acelerómetro. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Accelerometer, y una posición que muestra la fuerza g en cada eje del dispositivo local. Este evento solo se activa localmente.

    UserInputService DeviceRotationChanged(Rotación de InputObject, CFrame cframe)

    Se activa cuando un usuario gira un dispositivo que tiene un giroscopio. Esto se dispara con un InputObject, que tiene el tipo Enum.InputType.Gyroscope, y una posición que muestra la rotación total en cada eje del dispositivo local. La propiedad delta describe la cantidad de rotación que ocurrió por última vez. Un segundo argumento de Vector4 es la rotación del cuaternión actual del dispositivo en referencia a su marco de referencia predeterminado. Este evento solo se activa localmente.

    UserInputService Mando conectado(UserInputType gamepadNum)

    UserInputService Gamepad Desconectado(UserInputType gamepadNum)

    UserInputService Entrada Comenzó(Entrada InputObject, bool gameProcessedEvent)

    Se activa cuando un usuario comienza a interactuar a través de un dispositivo de interfaz persona-computadora (botón del mouse hacia abajo, inicio táctil, botón del teclado hacia abajo, etc.). 'inputObject' es un UserInputServiceInputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService InputChanged(Entrada InputObject, bool gameProcessedEvent)

    Se activa cuando un usuario cambia de interacción a través de un dispositivo de interfaz persona-computadora (movimiento del mouse, movimiento táctil, rueda del mouse, etc.). 'inputObject' es un InputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService InputEnded(Entrada InputObject, bool gameProcessedEvent)

    Se activa cuando un usuario deja de interactuar a través de un dispositivo de interfaz persona-computadora (botón del mouse hacia arriba, extremo táctil, botón del teclado hacia arriba, etc.). 'inputObject' es un InputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService JumpRequest()

    Dispara cuando el jugador local solicita saltar.

    UserInputService LastInputTypeChanged(UserInputType lastInputType)

    UserInputService PunteroAcción(rueda flotante, bandeja Vector2, pellizco flotante, juego boolProcessedEvent)

    UserInputService StatusBarTapped(Posición Vector2)

    • Seguridad: RobloxScriptSecurity.

    UserInputService TextBoxFocusReleased(TextBox textboxReleased)

    Se activa cuando un usuario detiene la entrada de texto en un cuadro de texto (generalmente presionando retorno o haciendo clic / tocando en otro lugar de la pantalla). El argumento es el cuadro de texto desenfocado. Este evento solo se activa localmente.

    UserInputService TextBoxFocused(TextBox textboxFocused)

    Se activa cuando un usuario hace clic o toca un cuadro de texto para comenzar a ingresar texto. El argumento es el cuadro de texto que se enfocó. Esto también se activa si un cuadro de texto obliga a centrarse en el usuario. Este evento solo se activa localmente.

    UserInputService TouchEnded(InputObject touch, bool gameProcessedEvent)

    Se activa cuando un usuario mueve el dedo en un dispositivo TouchEnabled. 'touch' es un InputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchLongPress(Array touchPositions, estado UserInputState, bool gameProcessedEvent)

    Se activa cuando un usuario sostiene al menos un dedo durante un breve período de tiempo en la misma posición de la pantalla en un dispositivo TouchEnabled. 'touchPositions' es una matriz Lua de Vector2, cada una indica la posición de todos los dedos involucrados en el gesto. 'state' indica el Enum.UserInputState del gesto. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchMoved(InputObject touch, bool gameProcessedEvent)

    Se activa cuando un usuario mueve el dedo en un dispositivo TouchEnabled. 'touch' es un InputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchPan(Array touchPositions, Vector2 totalTranslation, Vector2 velocity, estado UserInputState, bool gameProcessedEvent)

    Se activa cuando un usuario arrastra al menos un dedo en un dispositivo TouchEnabled. 'touchPositions' es una matriz Lua de Vector2, cada una indica la posición de todos los dedos involucrados en el gesto. 'totalTranslation' es un Vector2, que indica qué tan lejos ha ido el gesto de panorámica desde su punto de partida. 'velocidad' es un Vector2 que indica la rapidez con la que se realiza el gesto en cada dimensión. 'state' indica el Enum.UserInputState del gesto. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchPinch(Array touchPositions, escala flotante, velocidad flotante, estado UserInputState, bool gameProcessedEvent)

    Se activa cuando un usuario pellizca sus dedos en un dispositivo TouchEnabled. 'touchPositions' es una matriz Lua de Vector2, cada una indica la posición de todos los dedos involucrados en el gesto de pellizcar. 'scale' es un flotador que indica la diferencia desde el comienzo del gesto de pellizcar. 'velocidad' es un flotador que indica qué tan rápido está sucediendo el gesto de pellizcar. 'state' indica el Enum.UserInputState del gesto. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchRotate(Array touchPositions, rotación flotante, velocidad flotante, estado UserInputState, bool gameProcessedEvent)

    Se activa cuando un usuario gira dos dedos en un dispositivo TouchEnabled. 'touchPositions' es una matriz Lua de Vector2, cada una indica la posición de todos los dedos involucrados en el gesto. 'rotación' es un flotador que indica cuánto ha ido la rotación desde el inicio del gesto. 'velocidad' es un flotador que indica la rapidez con la que se realiza el gesto. 'state' indica el Enum.UserInputState del gesto. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchStarted(InputObject touch, bool gameProcessedEvent)

    Se activa cuando un usuario coloca su dedo en un dispositivo TouchEnabled. 'touch' es un InputObject, que contiene datos útiles para consultar la entrada del usuario. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchSwipe(SwipeDirection swipeDirection, int numberOfTouches, bool gameProcessedEvent)

    Se activa cuando un usuario desliza los dedos en un dispositivo TouchEnabled. 'swipeDirection' es un Enum.SwipeDirection, que indica la dirección en la que el usuario deslizó. 'numberOfTouches' es un int que indica cuántos toques estuvieron involucrados con el gesto. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService Toque Toque(Array touchPositions, bool gameProcessedEvent)

    Se activa cuando un usuario toca con el dedo un dispositivo TouchEnabled. 'touchPositions' es una matriz Lua de Vector2, cada uno indica la posición de todos los dedos involucrados en el gesto de tocar. Este evento solo se activa localmente. Este evento siempre se activará independientemente del estado del juego.

    UserInputService TouchTapInWorld(Posición Vector2, bool procesadoByUI)

    UserInputService UserCFrameChanged(Tipo de UserCFrame, valor de CFrame)

    UserInputService WindowFocusReleased()

    UserInputService WindowFocused()

    Enlaces externos

    Añade un comentario de UserInputService
    ¡Comentario enviado con éxito! Lo revisaremos en las próximas horas.