En esta página

XrInputAction QML Type

Representa una acción de un controlador de entrada. Más...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

QtObject

Propiedades

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:

ConstanteDescripción
XrInputAction.Button1PressedEl botón 1 está pulsado. Booleano.
XrInputAction.Button1TouchedEl botón 1 está pulsado. Booleana.
XrInputAction.Button2PressedBotón 2 pulsado. Booleano.
XrInputAction.Button2TouchedSe toca el botón 2. Booleano.
XrInputAction.ButtonMenuPressedSe pulsa el botón de menú. Booleano.
XrInputAction.ButtonMenuTouchedSe toca el botón de menú. Booleano.
XrInputAction.ButtonSystemPressedSe pulsa el botón del sistema. Booleano.
XrInputAction.ButtonSystemTouchedSe toca el botón del sistema. Booleano.
XrInputAction.SqueezeValueHasta dónde se pulsa el botón de agarre. Analógico.
XrInputAction.SqueezeForceLa fuerza aplicada al botón de agarre. Analógico.
XrInputAction.SqueezePressedEl botón de agarre está pulsado. Booleano.
XrInputAction.TriggerValueLa distancia a la que se pulsa el botón de disparo. Analógico.
XrInputAction.TriggerPressedEl gatillo está pulsado. Booleano.
XrInputAction.TriggerTouchedSe toca el disparador. Booleano.
XrInputAction.ThumbstickXEl valor del eje X del thumbstick. Analógico.
XrInputAction.ThumbstickYEl valor del eje Y del thumbstick. Analógico.
XrInputAction.ThumbstickPressedEl thumbstick está pulsado. Booleano.
XrInputAction.ThumbstickTouchedEl thumbstick es tocado. Booleano.
XrInputAction.ThumbrestTouchedSe toca el thumbstick. Booleano.
XrInputAction.TrackpadXLa posición del eje X en el trackpad. Analógico.
XrInputAction.TrackpadYLa posición del eje Y en el trackpad. Analógico.
XrInputAction.TrackpadForceLa fuerza aplicada sobre el trackpad. Analógico.
XrInputAction.TrackpadTouchedSe toca el trackpad. Booleano.
XrInputAction.TrackpadPressedEl trackpad está pulsado. Booleano.
XrInputAction.IndexFingerPinchGesto de pellizco del pulgar al índice. Booleano.
XrInputAction.MiddleFingerPinchPellizco del pulgar con el dedo corazón. Booleano.
XrInputAction.RingFingerPinchPellizco del pulgar al anular. Gesto booleano.
XrInputAction.LittleFingerPinchPellizco del pulgar al meñique. Gesto booleano.
XrInputAction.HandTrackingMenuPressGesto 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

ConstanteDescripció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.