XrInputAction QML Type
入力コントローラからのアクションを表します。詳細...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technical Preview |
プロパティ
- actionId : List<enumeration>
- actionName : string
- pressed : bool
- value : float
シグナル
詳細説明
アクションには、ボタン押下のようなブーリアン、ジョイスティックの軸のようなアナログがあります。
ブーリアンアクションに反応するには、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 が設定されている場合は影響しません。
pressed : bool |
入力アクションが現在押されているかどうかを示します。
このプロパティを使用して、入力アクション（ボタンなど）が現在押されているかどうかを確認します。
value : float |
入力アクションのアナログ値。
サムスティックの位置のようなアナログ入力の場合、このプロパティは入力値を保持する（通常は[0, 1]の範囲）。
シグナルの説明
triggered() |
このシグナルは、ブーリアンアクションがアクティブになったときに発せられる。これはpressed プロパティがtrue に設定されると同時に発生する。
注: 対応するハンドラはonTriggered です。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
