手柄

用于监听指定参训人员的手柄按键和输入操作。

资源文件

项目	内容
分类	交互外设
最新资源	外设-手柄v2.0.2.xobj
原始说明	外设-手柄_文档.json
更新记录	更新记录.md
来源目录	通用外设/外设资源/外设-手柄

使用前提

• 已将 外设-手柄v2.0.2.xobj 导入课程工程。
• 已将 XR 左右手柄绑定到对应参训人员，并确认平台能够区分左手柄和右手柄。
• 已明确需要监听主按键、次按键、摇杆键、扳机键、握键或菜单键中的哪些输入。
• 使用键盘模拟时，左右手柄的 12 个按键映射已核对且不与课程快捷键冲突。

参数说明

属性栏提供模拟输入、快捷键面板和 XR 左右手柄按键映射。

参数	作用	推荐配置	注意事项
是否打开快捷键面板	控制是否显示手柄模拟快捷键。	调试时开启，正式训练时按需关闭。	仅影响快捷键提示面板。
是否在试玩和实训端模拟该设备	允许通过键盘模拟 XR 手柄输入。	无实体手柄调试时开启；接入真实手柄后按需关闭。	模拟输入与真实手柄输入并用时，注意避免重复触发。
XR左手柄主按键	设置左手柄主按键的模拟键。	默认 F1。	避免与课程中的其他快捷键冲突。
XR左手柄次按键	设置左手柄次按键的模拟键。	默认 F2。	避免与课程中的其他快捷键冲突。
XR左手柄摇杆键	设置按下左摇杆的模拟键。	默认 F3。	此参数表示摇杆按键，不是摇杆方向。
XR左手柄扳机键	设置左扳机键的模拟键。	默认 F4。	与握键区分配置。
XR左手柄握键	设置左握键的模拟键。	默认 F5。	与扳机键区分配置。
XR左手柄菜单键	设置左手柄菜单键的模拟键。	默认 F6。	避免与系统或课程菜单快捷键冲突。
XR右手柄主按键	设置右手柄主按键的模拟键。	默认 F7。	避免与课程中的其他快捷键冲突。
XR右手柄次按键	设置右手柄次按键的模拟键。	默认 F8。	避免与课程中的其他快捷键冲突。
XR右手柄摇杆键	设置按下右摇杆的模拟键。	默认 F9。	此参数表示摇杆按键，不是摇杆方向。
XR右手柄扳机键	设置右扳机键的模拟键。	默认 F10。	与握键区分配置。
XR右手柄握键	设置右握键的模拟键。	默认 F11。	与扳机键区分配置。
XR右手柄菜单键	设置右手柄菜单键的模拟键。	默认 F12。	避免与系统或课程菜单快捷键冲突。

监听事件

事件	触发条件	典型用途
对的进行	指定参训实体按下手柄的任意按键时触发。	触发操作计分、提示或后续课程逻辑。

可执行行为

原始说明未提供可执行的实体内部行为。

使用步骤

1. 导入资源并将左右 XR 手柄绑定到对应参训人员。
2. 确定是否启用模拟设备和快捷键面板，核对 F1 至 F12 的左右手柄映射。
3. 在手柄事件中选择参训实体、左手柄或右手柄、具体按键和按下/松开等操作类型。
4. 将不同按键事件分别连接到交互、菜单、抓取、确认或评分逻辑。
5. 按左手柄和右手柄逐键测试，确认主次按键、摇杆键、扳机键、握键和菜单键没有串联。

常见问题

问题	建议
左手柄按键触发了右手柄逻辑。	检查事件中的手柄侧别，并确认左右手柄没有绑定错误。
按键按下有效，松开无效。	检查事件的操作类型是否只选择了按下，并为松开状态单独配置事件。
摇杆移动没有触发“摇杆键”。	“摇杆键”表示按下摇杆，不表示摇杆方向；方向输入需要使用其他对应资源或逻辑。
真实手柄和模拟按键各触发一次。	接入真实手柄时关闭不需要的模拟设备选项，并检查资源是否重复放置。