XrInputAction QML Type

入力コントローラーからのアクションを表します。詳細...

この型はテクノロジープレビュー版であり、変更される可能性があります。

• 継承されたメンバーを含む、すべてのメンバーの一覧
• 非推奨のメンバー

プロパティ

• actionId : List<enumeration>
• actionName : string
• controller : enumeration (since 6.10)
• enabled : bool (since 6.9)
• pressed : bool
• value : real

信号

• triggered()

詳細な説明

アクションには、ボタンの押下などのブール型や、ジョイスティックの軸などのアナログ型があります。

ブール値のアクションに反応するには、pressed プロパティまたはtriggered シグナルを使用します。アナログアクションは、value プロパティを設定します。

以下に、右手グリップの押下、またはハンドトラッキングによる右手のピンチジェスチャーのいずれかに反応する方法を示します。

XrInputAction {
    hand: XrInputAction.RightHand
    actionId: [XrInputAction.SqueezePressed, XrInputAction.SqueezeValue, XrInputAction.IndexFingerPinch]
    onTriggered: console.log("Do action here.")
}

SqueezePressed とSqueezeValue の両方を指定する理由は、アナロググリップボタンを備えたコントローラーもあれば、単にオン/オフのグリップスイッチしか備えていないコントローラーもあるためです。

プロパティのドキュメント

actionId : List<enumeration>

反応するアクションを指定します

以下の値を取り得るIDのリストを保持します：

actionName : string

入力アクションの名前。

このプロパティを使用して、反応させたいカスタム入力アクションの名前を指定します。actionId が設定されている場合、このプロパティは効果を持ちません。

controller : enumeration [since 6.10]

この入力アクションが適用されるコントローラー。

反応するコントローラーを指定します。

以下のいずれかです：

このプロパティは Qt 6.10 で導入されました。

enabled : bool [default: true, since 6.9]

このプロパティは、入力アクションがイベントに反応するかどうかを決定します。

このプロパティは Qt 6.9 で導入されました。

pressed : bool

入力アクションが現在押されているかどうかを示します。

このプロパティを使用して、入力アクション（ボタンなど）が現在押されているかどうかを確認します。

value : real

入力アクションのアナログ値。

サムスティックの位置などのアナログ入力の場合、このプロパティには入力の値（通常は [0, 1] の範囲）が格納されます。

シグナルのドキュメント

triggered()

このシグナルは、ブール型アクションが起動されたときに発火します。これは、pressed プロパティがtrue に設定されるのと同時に発生します。