XrInputAction QML Type
入力コントローラからのアクションを表します。詳細...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technical Preview |
プロパティ
- actionId : List<enumeration>
- actionName : string
- hand : enumeration
- pressed : bool
- value : real
信号
詳細説明
アクションには、ボタン押下のようなブーリアン、またはジョイスティックの軸のようなアナログがあります。
ブーリアンアクションに反応するには、pressed プロパティまたはtriggered シグナルを使用します。アナログアクションは、value プロパティを設定します。
注： 便宜上、アナログ・プロパティはpressed プロパティも設定し、triggered シグナルを発信します。一方、ブーリアン・プロパティは、押されるとvalue を 1.0 に設定します。
以下は、右手のグリップが押されたとき、またはハンドトラッキングから右手をつまむジェスチャーに反応する方法を示しています：
XrInputAction { hand: XrInputAction.RightHand actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch] onTriggered: console.log("Do action here.") }
SqueezePressed とSqueezeValue の両方を指定する理由は、コントローラによってはアナログのグリップボタンがあったり、グリップスイッチのオン/オフしかなかったりするからです。
プロパティ ドキュメント
actionId : List<enumeration> |
反応するアクションを指定します。
以下の値のIDのリストを保持します：
| 定数 | 説明 |
|---|---|
XrInputAction.Button1Pressed | ボタン1が押されたブール値。 |
XrInputAction.Button1Touched | ボタン1がタッチされた。ブール値。 |
XrInputAction.Button2Pressed | ボタン2が押された。ブール値。 |
XrInputAction.Button2Touched | ボタン2がタッチされた。ブール値。 |
XrInputAction.ButtonMenuPressed | メニューボタンが押された。ブール値。 |
XrInputAction.ButtonMenuTouched | メニューボタンがタッチされた。ブール値。 |
XrInputAction.ButtonSystemPressed | システムボタンが押された。ブール値。 |
XrInputAction.ButtonSystemTouched | システムボタンがタッチされた。ブール値。 |
XrInputAction.SqueezeValue | グリップ・ボタンがどこまで押されたか。アナログ。 |
XrInputAction.SqueezeForce | グリップボタンに加えられた力。アナログ。 |
XrInputAction.SqueezePressed | グリップボタンが押された状態。ブール値。 |
XrInputAction.TriggerValue | トリガーボタンが押された距離アナログ。 |
XrInputAction.TriggerPressed | トリガーが押されている。ブール値。 |
XrInputAction.TriggerTouched | トリガーがタッチされた。ブール値。 |
XrInputAction.ThumbstickX | サムスティックのX軸の値。アナログ。 |
XrInputAction.ThumbstickY | サムスティックのY軸の値。アナログ。 |
XrInputAction.ThumbstickPressed | サムスティックが押されている。ブール値。 |
XrInputAction.ThumbstickTouched | サムスティックがタッチされている。ブール値。 |
XrInputAction.ThumbrestTouched | サムレストに触れている。ブール値。 |
XrInputAction.TrackpadX | トラックパッドのX軸位置。アナログ。 |
XrInputAction.TrackpadY | トラックパッド上の Y 軸位置。アナログ。 |
XrInputAction.TrackpadForce | トラックパッドにかかる力。アナログ。 |
XrInputAction.TrackpadTouched | トラックパッドがタッチされている。ブール値。 |
XrInputAction.TrackpadPressed | トラックパッドが押されている。ブール値。 |
XrInputAction.IndexFingerPinch | 親指から人差し指へのピンチジェスチャー。ブール値。 |
XrInputAction.MiddleFingerPinch | 親指で中指をピンチするジェスチャ。ブール値。 |
XrInputAction.RingFingerPinch | 親指から薬指へのピンチジェスチャー。ブール。 |
XrInputAction.LittleFingerPinch | 親指から小指へのピンチジェスチャー。ブール値。 |
XrInputAction.HandTrackingMenuPress | ハンド トラッキング メニュー ジェスチャ。ブール値。 |
actionName : string |
入力アクションの名前。
このプロパティを使用して、反応させたいカスタム入力アクションの名前を指定します。このプロパティは、actionId が設定されている場合は影響しません。
hand : enumeration |
この入力アクションが適用される手。
反応するハンドを指定します。
以下のいずれかを指定します：
| 定数 | 値 |
|---|---|
XrInputAction.LeftHand | |
XrInputAction.RightHand | |
XrInputAction.Unknown |
pressed : bool |
入力アクションが現在押されているかどうかを示します。
入力アクション（例えばボタン）が現在押されているかどうかを確認するには、このプロパティを使用します。
value : real |
入力アクションのアナログ値。
サムスティックの位置のようなアナログ入力の場合、このプロパティは入力値を保持する（通常は[0, 1]の範囲）。
シグナルの説明
triggered() |
このシグナルは、ブーリアンアクションがアクティブになったときに発せられる。これはpressed プロパティがtrue に設定されると同時に発生する。
注： 対応するハンドラは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.
