XrInputAction QML Type
Stellt eine Aktion von einer Eingabesteuerung dar. Mehr...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technical Preview |
Eigenschaften
- actionId : List<enumeration>
- actionName : string
- hand : enumeration
- pressed : bool
- value : real
Signale
Detaillierte Beschreibung
Aktionen können boolesch sein, wie z.B. ein Tastendruck, oder analog, wie z.B. eine Joystick-Achse.
Verwenden Sie die Eigenschaft pressed oder das Signal triggered, um auf eine boolesche Aktion zu reagieren. Bei einer analogen Aktion wird die Eigenschaft value gesetzt.
Hinweis: Der Einfachheit halber setzt eine analoge Eigenschaft auch die Eigenschaft pressed und gibt das Signal triggered aus, während eine boolesche Eigenschaft value auf 1,0 setzt, wenn sie gedrückt wird.
Im Folgenden wird gezeigt, wie man entweder auf das Drücken des rechten Handgriffs oder auf eine Geste des Zwickens der rechten Hand durch die Handverfolgung reagiert:
XrInputAction { hand: XrInputAction.RightHand actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch] onTriggered: console.log("Do action here.") }
Der Grund für die Angabe von sowohl SqueezePressed als auch SqueezeValue ist, dass einige Controller eine analoge Grifftaste haben und einige Controller nur einen Ein-/Ausschalter für den Griff.
Eigenschaft Dokumentation
actionId : List<enumeration> |
Gibt die Aktion(en) an, auf die reagiert werden soll
Enthält eine Liste von IDs, die die folgenden Werte haben können:
| Konstante | Beschreibung |
|---|---|
XrInputAction.Button1Pressed | Taste 1 ist gedrückt. Boolesch. |
XrInputAction.Button1Touched | Taste 1 wurde berührt. Boolescher Wert. |
XrInputAction.Button2Pressed | Taste 2 ist gedrückt. Boolescher Wert. |
XrInputAction.Button2Touched | Taste 2 wird berührt. Boolescher Wert. |
XrInputAction.ButtonMenuPressed | Die Menütaste wird gedrückt. Boolescher Wert. |
XrInputAction.ButtonMenuTouched | Die Menütaste wird berührt. Boolescher Wert. |
XrInputAction.ButtonSystemPressed | Die Systemtaste wird gedrückt. Boolescher Wert. |
XrInputAction.ButtonSystemTouched | Die Systemtaste wurde berührt. Boolescher Wert. |
XrInputAction.SqueezeValue | Wie weit wird die Grifftaste gedrückt. Analog. |
XrInputAction.SqueezeForce | Die auf die Grifftaste ausgeübte Kraft. Analog. |
XrInputAction.SqueezePressed | Die Grifftaste ist gedrückt. Boolesch. |
XrInputAction.TriggerValue | Wie weit die Auslösetaste gedrückt wird. Analog. |
XrInputAction.TriggerPressed | Der Abzug ist gedrückt. Boolescher Wert. |
XrInputAction.TriggerTouched | Der Auslöser wurde berührt. Boolesch. |
XrInputAction.ThumbstickX | Der X-Achsenwert des Thumbsticks. Analog. |
XrInputAction.ThumbstickY | Der Y-Achsenwert des Thumbsticks. Analog. |
XrInputAction.ThumbstickPressed | Der Thumbstick ist gedrückt. Boolesch. |
XrInputAction.ThumbstickTouched | Der Thumbstick wurde berührt. Boolesch. |
XrInputAction.ThumbrestTouched | Die Daumenstütze wird berührt. Boolescher Wert. |
XrInputAction.TrackpadX | Die Position der X-Achse auf dem Trackpad. Analog. |
XrInputAction.TrackpadY | Die Position der Y-Achse auf dem Trackpad. Analog. |
XrInputAction.TrackpadForce | Die auf das Trackpad ausgeübte Kraft. Analog. |
XrInputAction.TrackpadTouched | Das Trackpad wird berührt. Boolesch. |
XrInputAction.TrackpadPressed | Das Trackpad ist gedrückt. Boolesch. |
XrInputAction.IndexFingerPinch | Daumen-Zeigefinger-Klemmgeste. Boolescher Wert. |
XrInputAction.MiddleFingerPinch | Daumen zu Mittelfinger kneifen Geste. Boolescher Wert. |
XrInputAction.RingFingerPinch | Daumen zu Ringfinger kneifen. Boolesch. |
XrInputAction.LittleFingerPinch | Daumen zu kleinem Finger kneifen Geste. Boolesch. |
XrInputAction.HandTrackingMenuPress | Geste für Handverfolgung im Menü. Boolescher Wert. |
actionName : string |
Der Name der Eingabeaktion.
Verwenden Sie diese Eigenschaft, um den Namen der benutzerdefinierten Eingabeaktion anzugeben, auf die Sie reagieren möchten. Diese Eigenschaft hat keine Auswirkung, wenn actionId eingestellt ist.
hand : enumeration |
Die Hand, auf die diese Eingabeaktion angewendet wird.
Gibt die Hand an, auf die reagiert werden soll.
Sie kann eine der folgenden sein:
| Konstante | Wert |
|---|---|
XrInputAction.LeftHand | |
XrInputAction.RightHand | |
XrInputAction.Unknown |
pressed : bool |
Zeigt an, ob die Eingabeaktion gerade gedrückt ist.
Verwenden Sie diese Eigenschaft, um zu prüfen, ob die Eingabeaktion (z. B. eine Taste) gerade gedrückt ist.
value : real |
Der analoge Wert der Eingabeaktion.
Bei analogen Eingaben, wie z. B. der Position eines Thumbsticks, enthält diese Eigenschaft den Wert der Eingabe (normalerweise im Bereich [0, 1]).
Signal Dokumentation
triggered() |
Dieses Signal wird ausgesendet, wenn eine boolesche Aktion aktiviert wird. Dies geschieht zur gleichen Zeit, wenn die Eigenschaft pressed auf true gesetzt wird.
Hinweis: Der entsprechende Handler ist onTriggered.
© 2025 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.
