XrInputAction QML Type
Representa una acción procedente de un controlador de entrada. Más información...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Propiedades
- actionId : List<enumeration>
- actionName : string
- controller : enumeration
(since 6.10) - enabled : bool
(since 6.9) - pressed : bool
- value : real
Señales
Descripción detallada
Las acciones pueden ser booleanas, como pulsar un botón, o analógicas, como el eje de un joystick.
Utiliza la propiedad « pressed » o la señal « triggered » para reaccionar ante una acción booleana. Una acción analógica establecerá la propiedad « value ».
Nota: Para mayor comodidad, una propiedad analógica también establecerá la propiedad ` pressed ` y emitirá la señal ` triggered `, mientras que una propiedad booleana establecerá ` value ` en 1,0 cuando se pulse.
A continuación se muestra cómo reaccionar ante la pulsación del agarre de la mano derecha o ante un gesto de pellizco con la mano derecha a partir del seguimiento de manos:
XrInputAction {
hand: XrInputAction.RightHand
actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch]
onTriggered: console.log("Do action here.")
}La razón para especificar tanto SqueezePressed como SqueezeValue es que algunos mandos tienen un botón analógico en la empuñadura, mientras que otros solo cuentan con un interruptor de encendido/apagado en la misma.
Documentación de propiedades
actionId : List<enumeration>
Especifica la(s) acción(es) a la(s) que se debe reaccionar
Contiene una lista de identificadores que pueden tener los siguientes valores:
| Constante | Descripción |
|---|---|
XrInputAction.Button1Pressed | Se pulsa el botón 1. Booleano. |
XrInputAction.Button1Touched | Se toca el botón 1. Booleano. |
XrInputAction.Button2Pressed | Se pulsa el botón 2. Booleano. |
XrInputAction.Button2Touched | Se toca el botón 2. Booleano. |
XrInputAction.ButtonMenuPressed | Se pulsa el botón de menú. Booleano. |
XrInputAction.ButtonMenuTouched | Se ha tocado el botón de menú. Booleano. |
XrInputAction.ButtonSystemPressed | Se pulsa el botón de sistema. Booleano. |
XrInputAction.ButtonSystemTouched | Se toca el botón de sistema. Booleano. |
XrInputAction.SqueezeValue | Hasta qué punto se ha pulsado el botón de agarre. Analógico. |
XrInputAction.SqueezeForce | La fuerza aplicada al botón de agarre. Analógico. |
XrInputAction.SqueezePressed | Se pulsa el botón de agarre. Booleano. |
XrInputAction.TriggerValue | Hasta qué punto se ha pulsado el botón del gatillo. Analógico. |
XrInputAction.TriggerPressed | Se ha pulsado el gatillo. Booleano. |
XrInputAction.TriggerTouched | Se ha tocado el gatillo. Booleano. |
XrInputAction.ThumbstickX | El valor del eje X del joystick. Analógico. |
XrInputAction.ThumbstickY | El valor del eje Y del joystick. Analógico. |
XrInputAction.ThumbstickPressed | Se ha pulsado el joystick. Booleano. |
XrInputAction.ThumbstickTouched | Se toca el joystick. Booleano. |
XrInputAction.ThumbrestTouched | Se toca el reposapulgares. Booleano. |
XrInputAction.TrackpadX | La posición del eje X en el trackpad. Analógico. |
XrInputAction.TrackpadY | La posición del eje Y en el trackpad. Analógico. |
XrInputAction.TrackpadForce | La fuerza aplicada sobre el panel táctil. Analógico. |
XrInputAction.TrackpadTouched | Se toca el panel táctil. Booleano. |
XrInputAction.TrackpadPressed | Se ha pulsado el trackpad. Booleano. |
XrInputAction.IndexFingerPinch | Gesto de pellizco con el pulgar y el índice. Booleano. |
XrInputAction.MiddleFingerPinch | Gesto de pellizco con el pulgar y el dedo corazón. Booleano. |
XrInputAction.RingFingerPinch | Gesto de pellizco entre el pulgar y el dedo anular. Booleano. |
XrInputAction.LittleFingerPinch | Gesto de pellizco con el pulgar y el meñique. Booleano. |
XrInputAction.HandTrackingMenuPress | Gesto de menú mediante el seguimiento de la mano. Booleano. |
actionName : string
El nombre de la acción de entrada.
Utiliza esta propiedad para especificar el nombre de la acción de entrada personalizada a la que deseas responder. Esta propiedad no tiene ningún efecto si se ha establecido « actionId ».
controller : enumeration [since 6.10]
El controlador al que se aplicará esta acción de entrada.
Especifica el controlador al que debe reaccionar.
Puede ser una de las siguientes:
| Constante | Descripción |
|---|---|
XrInputAction.LeftController | |
XrInputAction.RightController | |
XrInputAction.Unknown | |
XrInputAction.LeftHand | (alias de LeftController) |
XrInputAction.RightHand | (alias de RightController)Nota: En Qt 6.9, esta propiedad se denominaba «hand». |
Esta propiedad se introdujo en Qt 6.10.
enabled : bool [default: true, since 6.9]
Esta propiedad determina si la acción de entrada reaccionará ante los eventos.
Esta propiedad se introdujo en Qt 6.9.
pressed : bool
Indica si la acción de entrada está pulsada en este momento.
Utiliza esta propiedad para comprobar si la acción de entrada (por ejemplo, un botón) está pulsada en este momento.
value : real
El valor analógico de la acción de entrada.
En el caso de las entradas analógicas, como la posición de un joystick, esta propiedad contiene el valor de la entrada (normalmente en el intervalo [0, 1]).
Documentación sobre señales
triggered()
Esta señal se emite cuando se activa una acción booleana. Esto ocurre al mismo tiempo que la propiedad « pressed » se establece en « true ».
Nota: El controlador correspondiente es onTriggered.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.