Sur cette page

XrInputAction QML Type

Représente une action provenant d'un contrôleur d'entrée. En savoir plus...

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

QtObject

Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

Signaux

Description détaillée

Les actions peuvent être booléennes, comme l'appui sur un bouton, ou analogiques, comme l'axe d'un joystick.

Utilisez la propriété « pressed » ou le signal « triggered » pour réagir à une action booléenne. Une action analogique définira la propriété « value ».

Remarque : pour plus de commodité, une propriété analogique définira également la propriété ` pressed ` et émettra le signal ` triggered `, tandis qu’une propriété booléenne définira ` value ` sur 1,0 lorsqu’elle est activée.

Voici comment réagir soit à l’actionnement de la poignée droite, soit à un geste de pincement de la main droite détecté par le suivi des mains :

XrInputAction {
    hand: XrInputAction.RightHand
    actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch]
    onTriggered: console.log("Do action here.")
}

La raison pour laquelle il faut spécifier à la fois ` SqueezePressed ` et ` SqueezeValue ` est que certaines manettes disposent d’un bouton de poignée analogique, tandis que d’autres ne possèdent qu’un interrupteur de poignée marche/arrêt.

Documentation des propriétés

actionId : List<enumeration>

Spécifie la ou les actions auxquelles réagir

Contient une liste d’identifiants pouvant prendre les valeurs suivantes :

ConstanteDescription
XrInputAction.Button1PressedLe bouton 1 est enfoncé. Booléen.
XrInputAction.Button1TouchedLe bouton 1 est touché. Booléen.
XrInputAction.Button2PressedLe bouton 2 est enfoncé. Booléen.
XrInputAction.Button2TouchedLe bouton 2 est touché. Booléen.
XrInputAction.ButtonMenuPressedLe bouton Menu est enfoncé. Booléen.
XrInputAction.ButtonMenuTouchedLe bouton Menu est touché. Booléen.
XrInputAction.ButtonSystemPressedLe bouton système est enfoncé. Booléen.
XrInputAction.ButtonSystemTouchedLe bouton système est touché. Booléen.
XrInputAction.SqueezeValueProfondeur d'enfoncement du bouton de préhension. Analogique.
XrInputAction.SqueezeForceForce appliquée sur le bouton de préhension. Analogique.
XrInputAction.SqueezePressedLe bouton de la poignée est enfoncé. Booléen.
XrInputAction.TriggerValueProfondeur d'enfoncement du bouton de la gâchette. Analogique.
XrInputAction.TriggerPressedLa gâchette est enfoncée. Booléen.
XrInputAction.TriggerTouchedLa gâchette est effleurée. Booléen.
XrInputAction.ThumbstickXLa valeur de l'axe X du joystick. Analogique.
XrInputAction.ThumbstickYValeur de l'axe Y du joystick. Analogique.
XrInputAction.ThumbstickPressedLe joystick est enfoncé. Booléen.
XrInputAction.ThumbstickTouchedLe joystick est effleuré. Booléen.
XrInputAction.ThumbrestTouchedLe repose-pouce est touché. Booléen.
XrInputAction.TrackpadXLa position sur l'axe X du pavé tactile. Analogique.
XrInputAction.TrackpadYLa position sur l'axe Y du pavé tactile. Analogique.
XrInputAction.TrackpadForceLa force exercée sur le pavé tactile. Analogique.
XrInputAction.TrackpadTouchedLe pavé tactile est touché. Booléen.
XrInputAction.TrackpadPressedLe pavé tactile est enfoncé. Booléen.
XrInputAction.IndexFingerPinchGeste de pincement entre le pouce et l'index. Booléen.
XrInputAction.MiddleFingerPinchGeste de pincement entre le pouce et le majeur. Booléen.
XrInputAction.RingFingerPinchGeste de pincement entre le pouce et l'annulaire. Booléen.
XrInputAction.LittleFingerPinchGeste de pincement entre le pouce et l'auriculaire. Booléen.
XrInputAction.HandTrackingMenuPressGeste de menu par suivi de la main. Booléen.

actionName : string

Nom de l'action d'entrée.

Utilisez cette propriété pour spécifier le nom de l'action d'entrée personnalisée à laquelle vous souhaitez réagir. Cette propriété n'a aucun effet si la propriété « actionId » est définie.

controller : enumeration [since 6.10]

Le contrôleur auquel cette action d'entrée s'appliquera.

Spécifie le contrôleur auquel réagir.

Il peut s'agir de l'une des valeurs suivantes :

ConstanteDescription
XrInputAction.LeftController 
XrInputAction.RightController 
XrInputAction.Unknown 
XrInputAction.LeftHand(alias de LeftController)
XrInputAction.RightHand(alias de RightController)

Remarque : dans Qt 6.9, cette propriété s'appelait « hand »

Cette propriété a été introduite dans Qt 6.10.

enabled : bool [default: true, since 6.9]

Cette propriété détermine si l'action d'entrée réagira aux événements.

Cette propriété a été introduite dans Qt 6.9.

pressed : bool

Indique si l'action d'entrée est actuellement activée.

Utilisez cette propriété pour vérifier si l'action d'entrée (par exemple, un bouton) est actuellement activée.

value : real

La valeur analogique de l'action d'entrée.

Pour les entrées analogiques, telles que la position d'un joystick, cette propriété contient la valeur de l'entrée (généralement comprise entre 0 et 1).

Documentation sur les signaux

triggered()

Ce signal est émis lorsqu'une action booléenne est activée. Cela se produit au moment où la propriété pressed prend la valeur true.

Remarque : le gestionnaire correspondant est 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.