En esta página

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:

QtObject

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

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:

ConstanteDescripción
XrInputAction.Button1PressedSe pulsa el botón 1. Booleano.
XrInputAction.Button1TouchedSe toca el botón 1. Booleano.
XrInputAction.Button2PressedSe pulsa el botón 2. Booleano.
XrInputAction.Button2TouchedSe toca el botón 2. Booleano.
XrInputAction.ButtonMenuPressedSe pulsa el botón de menú. Booleano.
XrInputAction.ButtonMenuTouchedSe ha tocado el botón de menú. Booleano.
XrInputAction.ButtonSystemPressedSe pulsa el botón de sistema. Booleano.
XrInputAction.ButtonSystemTouchedSe toca el botón de sistema. Booleano.
XrInputAction.SqueezeValueHasta qué punto se ha pulsado el botón de agarre. Analógico.
XrInputAction.SqueezeForceLa fuerza aplicada al botón de agarre. Analógico.
XrInputAction.SqueezePressedSe pulsa el botón de agarre. Booleano.
XrInputAction.TriggerValueHasta qué punto se ha pulsado el botón del gatillo. Analógico.
XrInputAction.TriggerPressedSe ha pulsado el gatillo. Booleano.
XrInputAction.TriggerTouchedSe ha tocado el gatillo. Booleano.
XrInputAction.ThumbstickXEl valor del eje X del joystick. Analógico.
XrInputAction.ThumbstickYEl valor del eje Y del joystick. Analógico.
XrInputAction.ThumbstickPressedSe ha pulsado el joystick. Booleano.
XrInputAction.ThumbstickTouchedSe toca el joystick. Booleano.
XrInputAction.ThumbrestTouchedSe toca el reposapulgares. 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 panel táctil. Analógico.
XrInputAction.TrackpadTouchedSe toca el panel táctil. Booleano.
XrInputAction.TrackpadPressedSe ha pulsado el trackpad. Booleano.
XrInputAction.IndexFingerPinchGesto de pellizco con el pulgar y el índice. Booleano.
XrInputAction.MiddleFingerPinchGesto de pellizco con el pulgar y el dedo corazón. Booleano.
XrInputAction.RingFingerPinchGesto de pellizco entre el pulgar y el dedo anular. Booleano.
XrInputAction.LittleFingerPinchGesto de pellizco con el pulgar y el meñique. Booleano.
XrInputAction.HandTrackingMenuPressGesto 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:

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