Auf dieser Seite

XrInputAction QML Type

Stellt eine Aktion eines Eingabecontrollers dar. Mehr...

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

QtObject

Status: Technology preview

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

Eigenschaften

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:

KonstanteBeschreibung
XrInputAction.Button1PressedTaste 1 wird gedrückt. Boolescher Wert.
XrInputAction.Button1TouchedTaste 1 wird berührt. Boolescher Wert.
XrInputAction.Button2PressedTaste 2 wird gedrückt. Boolescher Wert.
XrInputAction.Button2TouchedTaste 2 wird berührt. Boolescher Wert.
XrInputAction.ButtonMenuPressedDie Menütaste wird gedrückt. Boolescher Wert.
XrInputAction.ButtonMenuTouchedDie Menütaste wird berührt. Boolescher Wert.
XrInputAction.ButtonSystemPressedDie Systemtaste wird gedrückt. Boolescher Wert.
XrInputAction.ButtonSystemTouchedDie Systemtaste wird berührt. Boolesch.
XrInputAction.SqueezeValueWie stark die Griff-Taste gedrückt wird. Analog.
XrInputAction.SqueezeForceDie auf die Griff-Taste ausgeübte Kraft. Analog.
XrInputAction.SqueezePressedDie Griff-Taste wird gedrückt. Boolesch.
XrInputAction.TriggerValueWie weit die Abzugstaste gedrückt ist. Analog.
XrInputAction.TriggerPressedDer Abzug wird gedrückt. Boolescher Wert.
XrInputAction.TriggerTouchedDer Abzug wird berührt. Boolescher Wert.
XrInputAction.ThumbstickXDer Wert der X-Achse des Daumensticks. Analog.
XrInputAction.ThumbstickYDer Y-Achsen-Wert des Daumensticks. Analog.
XrInputAction.ThumbstickPressedDer Daumenstick wird gedrückt. Boolesch.
XrInputAction.ThumbstickTouchedDer Daumenstick wird berührt. Boolesch.
XrInputAction.ThumbrestTouchedDie Daumenauflage wird berührt. Boolescher Wert.
XrInputAction.TrackpadXDie Position auf der X-Achse des Trackpads. Analog.
XrInputAction.TrackpadYDie Y-Achsen-Position auf dem Trackpad. Analog.
XrInputAction.TrackpadForceDie auf das Trackpad ausgeübte Kraft. Analog.
XrInputAction.TrackpadTouchedDas Trackpad wird berührt. Boolesch.
XrInputAction.TrackpadPressedDas Trackpad wird gedrückt. Boolesch.
XrInputAction.IndexFingerPinchZwickgeste mit Daumen und Zeigefinger. Boolescher Wert.
XrInputAction.MiddleFingerPinchZwickgeste zwischen Daumen und Mittelfinger. Boolescher Wert.
XrInputAction.RingFingerPinchZwickgeste zwischen Daumen und Ringfinger. Boolesch.
XrInputAction.LittleFingerPinchZwickgeste zwischen Daumen und kleinem Finger. Boolesch.
XrInputAction.HandTrackingMenuPressHand-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:

KonstanteBeschreibung
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.