XrInputAction QML Type
Stellt eine Aktion eines Eingabecontrollers dar. Mehr...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.
Eigenschaften
- actionId : List<enumeration>
- actionName : string
- controller : enumeration
(since 6.10) - enabled : bool
(since 6.9) - pressed : bool
- value : real
Signale
Ausführliche Beschreibung
Aktionen können boolesch sein, wie beispielsweise ein Tastendruck, oder analog, wie beispielsweise eine Joystick-Achse.
Verwenden Sie die Eigenschaft „ pressed “ oder das Signal „ triggered “, um auf eine boolesche Aktion zu reagieren. Eine analoge Aktion setzt die Eigenschaft „ value “.
Hinweis: Der Einfachheithalber setzt eine analoge Eigenschaft auch die Eigenschaft „ pressed “ und löst das Signal „ triggered “ aus, während eine boolesche Eigenschaft bei Betätigung „ value “ auf 1,0 setzt.
Im Folgenden wird gezeigt, wie man entweder auf das Drücken des rechten Handgriffs oder auf eine Rechts-Zwickgeste aus der 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 sowohl von „ SqueezePressed “ als auch von „ SqueezeValue “ liegt darin, dass einige Controller über eine analoge Griff-Taste verfügen, während andere lediglich einen Ein-/Aus-Griffschalter haben.
Dokumentation der Eigenschaften
actionId : List<enumeration>
Legt die Aktion(en) fest, auf die reagiert werden soll(en)
Enthält eine Liste von IDs, die folgende Werte annehmen können:
| Konstante | Beschreibung |
|---|---|
XrInputAction.Button1Pressed | Taste 1 wird gedrückt. Boolescher Wert. |
XrInputAction.Button1Touched | Taste 1 wird berührt. Boolescher Wert. |
XrInputAction.Button2Pressed | Taste 2 wird 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 wird berührt. Boolesch. |
XrInputAction.SqueezeValue | Wie stark die Griff-Taste gedrückt wird. Analog. |
XrInputAction.SqueezeForce | Die auf die Griff-Taste ausgeübte Kraft. Analog. |
XrInputAction.SqueezePressed | Die Griff-Taste wird gedrückt. Boolesch. |
XrInputAction.TriggerValue | Wie weit die Abzugstaste gedrückt ist. Analog. |
XrInputAction.TriggerPressed | Der Abzug wird gedrückt. Boolescher Wert. |
XrInputAction.TriggerTouched | Der Abzug wird berührt. Boolescher Wert. |
XrInputAction.ThumbstickX | Der Wert der X-Achse des Daumensticks. Analog. |
XrInputAction.ThumbstickY | Der Y-Achsen-Wert des Daumensticks. Analog. |
XrInputAction.ThumbstickPressed | Der Daumenstick wird gedrückt. Boolesch. |
XrInputAction.ThumbstickTouched | Der Daumenstick wird berührt. Boolesch. |
XrInputAction.ThumbrestTouched | Die Daumenauflage wird berührt. Boolescher Wert. |
XrInputAction.TrackpadX | Die Position auf der X-Achse des Trackpads. Analog. |
XrInputAction.TrackpadY | Die Y-Achsen-Position 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 wird gedrückt. Boolesch. |
XrInputAction.IndexFingerPinch | Zwickgeste mit Daumen und Zeigefinger. Boolescher Wert. |
XrInputAction.MiddleFingerPinch | Zwickgeste zwischen Daumen und Mittelfinger. Boolescher Wert. |
XrInputAction.RingFingerPinch | Zwickgeste zwischen Daumen und Ringfinger. Boolesch. |
XrInputAction.LittleFingerPinch | Zwickgeste zwischen Daumen und kleinem Finger. Boolesch. |
XrInputAction.HandTrackingMenuPress | Hand-Tracking-Menü-Geste. 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 “ festgelegt ist.
controller : enumeration [since 6.10]
Der Controller, auf den diese Eingabeaktion angewendet wird.
Gibt den Controller an, auf den reagiert werden soll.
Mögliche Werte:
| Konstante | Beschreibung |
|---|---|
XrInputAction.LeftController | |
XrInputAction.RightController | |
XrInputAction.Unknown | |
XrInputAction.LeftHand | (Alias für LeftController) |
XrInputAction.RightHand | (Alias für RightController)Hinweis: In Qt 6.9 hieß diese Eigenschaft „hand“ |
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
enabled : bool [default: true, since 6.9]
Diese Eigenschaft legt fest, ob die Eingabeaktion auf Ereignisse reagiert.
Diese Eigenschaft wurde in Qt 6.9 eingeführt.
pressed : bool
Gibt an, ob die Eingabeaktion derzeit gedrückt ist.
Verwenden Sie diese Eigenschaft, um zu prüfen, ob die Eingabeaktion (z. B. eine Schaltfläche) derzeit gedrückt ist.
value : real
Der Analogwert der Eingabeaktion.
Bei analogen Eingaben, wie beispielsweise der Position eines Joysticks, enthält diese Eigenschaft den Wert der Eingabe (in der Regel im Bereich [0, 1]).
Signaldokumentation
triggered()
Dieses Signal wird ausgelöst, wenn eine boolesche Aktion aktiviert wird. Dies geschieht gleichzeitig mit der Einstellung der Eigenschaft „ pressed “ auf „ true “.
Hinweis: Der entsprechende Handler lautet „ 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.