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 。