XrInputAction QML Type
Representa una acción de un controlador de entrada. Más...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
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 la pulsación de un botón, o analógicas, como el eje de un joystick.
Utilice la propiedad pressed o la señal triggered para reaccionar a una acción booleana. Una acción analógica establecerá la propiedad value.
Nota: Por conveniencia, una propiedad analógica también establecerá la propiedad pressed y emitirá la señal triggered, mientras que una propiedad booleana establecerá value a 1.0 cuando se pulse.
A continuación se muestra cómo reaccionar a la pulsación del agarre de la mano derecha o a un gesto de pellizco de la mano derecha desde el seguimiento de la mano:
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 controladores tienen un botón de agarre analógico, y algunos controladores sólo tienen un interruptor de agarre de encendido/apagado.
Documentación de propiedades
actionId : List<enumeration>
Especifica la(s) acción(es) a la(s) que reaccionar
Contiene una lista de identificadores que pueden tener los siguientes valores:
| Constante | Descripción |
|---|---|
XrInputAction.Button1Pressed | El botón 1 está pulsado. Booleano. |
XrInputAction.Button1Touched | El botón 1 está pulsado. Booleana. |
XrInputAction.Button2Pressed | Botón 2 pulsado. Booleano. |
XrInputAction.Button2Touched | Se toca el botón 2. Booleano. |
XrInputAction.ButtonMenuPressed | Se pulsa el botón de menú. Booleano. |
XrInputAction.ButtonMenuTouched | Se toca el botón de menú. Booleano. |
XrInputAction.ButtonSystemPressed | Se pulsa el botón del sistema. Booleano. |
XrInputAction.ButtonSystemTouched | Se toca el botón del sistema. Booleano. |
XrInputAction.SqueezeValue | Hasta dónde se pulsa el botón de agarre. Analógico. |
XrInputAction.SqueezeForce | La fuerza aplicada al botón de agarre. Analógico. |
XrInputAction.SqueezePressed | El botón de agarre está pulsado. Booleano. |
XrInputAction.TriggerValue | La distancia a la que se pulsa el botón de disparo. Analógico. |
XrInputAction.TriggerPressed | El gatillo está pulsado. Booleano. |
XrInputAction.TriggerTouched | Se toca el disparador. Booleano. |
XrInputAction.ThumbstickX | El valor del eje X del thumbstick. Analógico. |
XrInputAction.ThumbstickY | El valor del eje Y del thumbstick. Analógico. |
XrInputAction.ThumbstickPressed | El thumbstick está pulsado. Booleano. |
XrInputAction.ThumbstickTouched | El thumbstick es tocado. Booleano. |
XrInputAction.ThumbrestTouched | Se toca el thumbstick. 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 trackpad. Analógico. |
XrInputAction.TrackpadTouched | Se toca el trackpad. Booleano. |
XrInputAction.TrackpadPressed | El trackpad está pulsado. Booleano. |
XrInputAction.IndexFingerPinch | Gesto de pellizco del pulgar al índice. Booleano. |
XrInputAction.MiddleFingerPinch | Pellizco del pulgar con el dedo corazón. Booleano. |
XrInputAction.RingFingerPinch | Pellizco del pulgar al anular. Gesto booleano. |
XrInputAction.LittleFingerPinch | Pellizco del pulgar al meñique. Gesto booleano. |
XrInputAction.HandTrackingMenuPress | Gesto de menú de seguimiento de la mano. Booleano. |
actionName : string
El nombre de la acción de entrada.
Utilice esta propiedad para especificar el nombre de la acción de entrada personalizada a la que desea reaccionar. Esta propiedad no tiene efecto si se establece actionId.
controller : enumeration [since 6.10]
El controlador al que se aplicará esta acción de entrada.
Especifica el controlador al que se reaccionará.
Puede ser uno de los siguientes
| Constante | Descripción |
|---|---|
XrInputAction.LeftController | |
XrInputAction.RightController | |
XrInputAction.Unknown | |
XrInputAction.LeftHand | (alias para LeftController) |
XrInputAction.RightHand | (alias para RightController) |
Nota: En Qt 6.9, esta propiedad se llamaba "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á a los eventos.
Esta propiedad se introdujo en Qt 6.9.
pressed : bool
Indica si la acción de entrada está actualmente pulsada.
Utilice esta propiedad para comprobar si la acción de entrada (por ejemplo, un botón) está actualmente pulsada.
value : real
El valor analógico de la acción de entrada.
Para entradas analógicas, como la posición de una palanca, esta propiedad contiene el valor de la entrada (normalmente en el rango [0, 1]).
Documentación de 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 manejador 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.