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: | |
| Status: | Technology preview |
Ce type est en préversion technologique et est susceptible d'être modifié.
Propriétés
- actionId : List<enumeration>
- actionName : string
- controller : enumeration
(since 6.10) - enabled : bool
(since 6.9) - pressed : bool
- value : real
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 :
| Constante | Description |
|---|---|
XrInputAction.Button1Pressed | Le bouton 1 est enfoncé. Booléen. |
XrInputAction.Button1Touched | Le bouton 1 est touché. Booléen. |
XrInputAction.Button2Pressed | Le bouton 2 est enfoncé. Booléen. |
XrInputAction.Button2Touched | Le bouton 2 est touché. Booléen. |
XrInputAction.ButtonMenuPressed | Le bouton Menu est enfoncé. Booléen. |
XrInputAction.ButtonMenuTouched | Le bouton Menu est touché. Booléen. |
XrInputAction.ButtonSystemPressed | Le bouton système est enfoncé. Booléen. |
XrInputAction.ButtonSystemTouched | Le bouton système est touché. Booléen. |
XrInputAction.SqueezeValue | Profondeur d'enfoncement du bouton de préhension. Analogique. |
XrInputAction.SqueezeForce | Force appliquée sur le bouton de préhension. Analogique. |
XrInputAction.SqueezePressed | Le bouton de la poignée est enfoncé. Booléen. |
XrInputAction.TriggerValue | Profondeur d'enfoncement du bouton de la gâchette. Analogique. |
XrInputAction.TriggerPressed | La gâchette est enfoncée. Booléen. |
XrInputAction.TriggerTouched | La gâchette est effleurée. Booléen. |
XrInputAction.ThumbstickX | La valeur de l'axe X du joystick. Analogique. |
XrInputAction.ThumbstickY | Valeur de l'axe Y du joystick. Analogique. |
XrInputAction.ThumbstickPressed | Le joystick est enfoncé. Booléen. |
XrInputAction.ThumbstickTouched | Le joystick est effleuré. Booléen. |
XrInputAction.ThumbrestTouched | Le repose-pouce est touché. Booléen. |
XrInputAction.TrackpadX | La position sur l'axe X du pavé tactile. Analogique. |
XrInputAction.TrackpadY | La position sur l'axe Y du pavé tactile. Analogique. |
XrInputAction.TrackpadForce | La force exercée sur le pavé tactile. Analogique. |
XrInputAction.TrackpadTouched | Le pavé tactile est touché. Booléen. |
XrInputAction.TrackpadPressed | Le pavé tactile est enfoncé. Booléen. |
XrInputAction.IndexFingerPinch | Geste de pincement entre le pouce et l'index. Booléen. |
XrInputAction.MiddleFingerPinch | Geste de pincement entre le pouce et le majeur. Booléen. |
XrInputAction.RingFingerPinch | Geste de pincement entre le pouce et l'annulaire. Booléen. |
XrInputAction.LittleFingerPinch | Geste de pincement entre le pouce et l'auriculaire. Booléen. |
XrInputAction.HandTrackingMenuPress | Geste 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 :
| Constante | Description |
|---|---|
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.